home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / os2 / 4os295.zip / 4OS2.DOC next >
Text File  |  1992-03-27  |  139KB  |  2,956 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                              44
  10.                             44
  11.                            44        OOOOO        SSSSSS       222222
  12.                           44        OOOOOOO      SSSSSSSS     22222222
  13.                          44  44    OO     OO    SS           22     22
  14.                         44   44    OO     OO    SS                  22
  15.                        44    44    OO     OO     SSSSSS            222
  16.                       444444444    OO     OO      SSSSSS         222
  17.                        44444444    OO     OO           SS      222
  18.                              44    OO     OO           SS    222
  19.                              44     OOOOOOO     SSSSSSSS     222222222
  20.                              44      OOOOO       SSSSSS      222222222
  21.  
  22.  
  23.  
  24.                             Version 0.95 (Shareware Pre-Release)
  25.  
  26.  
  27.  
  28.                                         Developed By
  29.                                   Rex Conn and Tom Rawson
  30.  
  31.  
  32.                                       Documentation By
  33.                          Hardin Brothers, Tom Rawson, and Rex Conn
  34.  
  35.  
  36.  
  37.  
  38.                                         Published By
  39.                                       JP Software Inc.
  40.                                        P.O. Box 1470
  41.                                   East Arlington, MA 02174
  42.                                             USA
  43.  
  44.                                        (617) 646-3975
  45.                                      fax (617) 646-0904
  46.  
  47.  
  48.  
  49.  
  50.                Program and Documentation Copyright 1988, 1989, 1990, 1991,
  51.                1992, Rex C. Conn and JP Software Inc., All Rights Reserved.
  52.                4OS2 is a trademark and 4DOS is a registered trademark of JP
  53.                Software Inc.  OS/2 is a registered trademark of IBM
  54.                Corporation.  Other product and company names are trademarks
  55.                of their respective owners.
  56.  
  57.  
  58.  
  59.  
  60.  
  61.                                     ACKNOWLEDGMENTS
  62.  
  63.  
  64.  
  65.  
  66.                We couldn't produce a product like 4OS2 without the dedication
  67.                and quality work of many people.  Our thanks to:
  68.  
  69.                     JP Software Staff:  Mike Bessy, Kevin Cocilo, Helen
  70.                     Coyne, Hayyim Feldman, Henry Harvey, Ellen Stone, Misty
  71.                     White.
  72.  
  73.                     Beta Test Support:  David Moskowitz, Guy Scharf, Larry
  74.                     Finkelstein, and Martin Schiff, of CompuServe's CONSULT
  75.                     forum.
  76.  
  77.                     Online Support:  Brian Miller and Tess Heder of Channel 1
  78.                     BBS; Don Watkins of CompuServe's IBMNET.
  79.  
  80.                     Help Text Conversion:  Matthew J. Palcic.
  81.  
  82.                     Beta Testers:  We can't list all of our beta testers
  83.                     here!  A special thanks to all of you who helped make
  84.                     4OS2 elegant, reliable, and friendly!
  85.  
  86.  
  87.  
  88.  
  89.  
  90.                The following tools are used in creating and maintaining 4OS2
  91.                and the 4OS2 Help:
  92.  
  93.                  Compilers:        Microsoft C 6.0 and Macro Assembler 5.1
  94.                                    and 6.0
  95.                  Libraries:        Spontaneous Assembly (Base Two
  96.                                    Development)
  97.                  Editors:          Edix (Emerging Technology), Brief
  98.                                    (Solution Systems)
  99.                  Version Control:  PVCS (Sage Software)
  100.                  Help Compiler:    IBM Information Presentation Facility
  101.                  Documentation:    Microsoft Word for Windows with Adobe Type
  102.                                    Manager
  103.  
  104.                Printing by Causeway Print, Boston.  Disk duplication by
  105.                Diversified Systems Group, Issaquah, WA.
  106.  
  107.                                                                      CONTENTS
  108.           ___________________________________________________________________
  109.  
  110.  
  111.  
  112.           Contents
  113.  
  114.  
  115.           Introduction ..........................................   1
  116.                How to Use This Manual ...........................   2
  117.  
  118.           Chapter 1 / Installation ..............................   4
  119.                Installing 4OS2 ..................................   4
  120.                Manual 4OS2 Installation .........................   4
  121.                     Manual Installation for OS/2 Version 1.x ....   5
  122.                     Manual Installation for OS/2 Version 2.0 ....   5
  123.                Uninstalling 4OS2 ................................   6
  124.  
  125.           Chapter 2 / General Concepts ..........................   7
  126.                Terminology ......................................   7
  127.                OS/2 Sessions and Applications ...................   7
  128.                     Sessions and Session Types ..................   8
  129.                     Applications and Application Types ..........  10
  130.                     Starting Sessions and Applications ..........  11
  131.                Creating and Configuring Icons ...................  12
  132.                     OS/2 Version 1.x Icons ......................  12
  133.                     OS/2 Version 2.0 Icons ......................  13
  134.                Primary and Secondary Shells .....................  13
  135.                High Performance File System (HPFS) ..............  14
  136.                Extended Attributes ..............................  15
  137.  
  138.           Chapter 3 / Using 4OS2 ................................  16
  139.                At the Command Line ..............................  16
  140.                     4OS2 HELP ...................................  16
  141.                     Shared History and Alias Lists ..............  17
  142.                     Multiple Commands ...........................  18
  143.                     Escape Character ............................  18
  144.                Redirection ......................................  18
  145.                Piping ...........................................  19
  146.                4OS2 Internal Variables ..........................  20
  147.                4OS2 Variable Functions ..........................  20
  148.                Batch Files ......................................  21
  149.                     4OS2 Startup and Exit Files .................  22
  150.                     Using STARTUP.CMD ...........................  22
  151.                     Using 4START and 4EXIT ......................  23
  152.                     REXX Support ................................  23
  153.                     EXTPROC Support .............................  24
  154.  
  155.           Chapter 4 / Configuration and Tuning ..................  26
  156.                Creating and Configuring 4OS2 Icons ..............  26
  157.                4OS2 Command Line Options ........................  27
  158.                Using 4OS2.INI ...................................  29
  159.                     4OS2.INI Directives .........................  29
  160.  
  161.           ___________________________________________________________________
  162.           Copyright 1992, JP Software Inc.        4OS2 Reference Manual  /  i
  163.  
  164.                                                                      CONTENTS
  165.           ___________________________________________________________________
  166.  
  167.  
  168.                Configuring 4OS2 Help ............................  30
  169.                Using 4DOS with OS/2 .............................  31
  170.                     Methods of Booting ..........................  33
  171.                     Setting Up OS/2 and 4DOS ....................  34
  172.                     Other 4DOS Considerations ...................  36
  173.                     "Temporary" VDMs ............................  37
  174.  
  175.           Chapter 5 / Command Reference Guide ...................  39
  176.                DETACH ...........................................  40
  177.                DIR ..............................................  41
  178.                DPATH ............................................  42
  179.                KEYS .............................................  43
  180.                SETDOS ...........................................  45
  181.                START ............................................  46
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.           ___________________________________________________________________
  219.           Copyright 1992, JP Software Inc.       4OS2 Reference Manual  /  ii
  220.  
  221.                                                                  INTRODUCTION
  222.           ___________________________________________________________________
  223.  
  224.  
  225.  
  226.           INTRODUCTION
  227.  
  228.  
  229.                Welcome, and thanks for trying 4OS2!
  230.  
  231.                We developed 4OS2 to bring the power and convenience of our
  232.                popular 4DOS program to users of the OS/2 operating system.
  233.                Whether you are a computer novice or an experienced user, we
  234.                think that 4OS2 will help you get the most out of your OS/2
  235.                computer.
  236.  
  237.                4OS2, like its cousin 4DOS, is a command interpreter or
  238.                "shell."  We have designed 4OS2 to be compatible with both
  239.                4DOS and with OS/2's normal shell program, which is called
  240.                CMD.EXE.
  241.  
  242.                If you are familiar with 4DOS or with the OS/2 command prompt,
  243.                you won't have to change your computing habits or unlearn
  244.                anything to use 4OS2.  If you know how to display a directory,
  245.                copy a file, or start an application program, you already know
  246.                how to use 4OS2.  And if you are a 4DOS user, you already know
  247.                how to use most of the advanced features that we have built
  248.                into 4OS2.  You can even use many of your 4DOS batch files
  249.                with 4OS2 without changing them at all.
  250.  
  251.                Once you have 4OS2 installed, you can learn its new features
  252.                at your own pace.  Relax, enjoy 4OS2's power, and browse
  253.                through the manuals occasionally.  Press the F1 key whenever
  254.                you need help.  4OS2 will soon become an essential part of
  255.                your computer, and you'll wonder how you ever got along
  256.                without it.
  257.  
  258.                This version of 4OS2 is designed for and has been tested with
  259.                OS/2 versions 1.2,. 1.21, 1.3, and 2.0.  You must have one of
  260.                these versions of OS/2 operating on your computer to be able
  261.                to install and use 4OS2.
  262.  
  263.                We are constantly working to improve 4OS2.  If you have
  264.                suggestions for features or commands that we should include in
  265.                the next version, or any other way we could improve our
  266.                product, please let us know.  Many of the features in this
  267.                version of 4OS2 were suggested by our users and beta testers,
  268.                and while we can't promise to include every suggestion, we
  269.                really do appreciate and pay attention to your comments.
  270.  
  271.  
  272.  
  273.  
  274.  
  275.           ___________________________________________________________________
  276.           Copyright 1992, JP Software Inc.        4OS2 Reference Manual  /  1
  277.  
  278.                                                                  INTRODUCTION
  279.           ___________________________________________________________________
  280.  
  281.  
  282.  
  283.  
  284.           How to Use This Manual
  285.  
  286.                Because 4OS2 is almost identical to 4DOS in operation, nearly
  287.                everything in the 4DOS Reference Manual applies to 4OS2 as
  288.                well.  Therefore, we supply both this manual and the 4DOS
  289.                Reference Manual with every copy of 4OS2.  Use the 4DOS
  290.                Reference Manual as your main 4OS2 manual;  this booklet is a
  291.                supplement which explains the added features in 4OS2 and the
  292.                occasional differences between the two products.
  293.  
  294.                We publish the manuals in this form because most 4OS2
  295.                customers also use 4DOS.  This supplement helps focus
  296.                attention on the few differences between 4OS2 and 4DOS;  two
  297.                completely separate manuals would make those differences more
  298.                difficult to pinpoint and to remember.
  299.  
  300.                If you aren't already familiar with 4DOS, we urge you to
  301.                install it in the OS/2 DOS box (OS/2 version 1.x) or a Virtual
  302.                Dos Machine (VDM of OS/2 version 2.0).  Try the Guided Tour of
  303.                4DOS (see chapter 3 of the 4DOS Reference Manual) and then
  304.                experiment with 4DOS.  Once you are familiar with 4DOS,
  305.                install 4OS2.  Installation instructions for both products are
  306.                in the next chapter.
  307.  
  308.                If you are familiar with 4DOS, you may want to read quickly
  309.                through this manual to get a general feeling for the few
  310.                differences between the two products.  Then you can install
  311.                4OS2 on your computer and study the differences that affect
  312.                your computing habits in detail.
  313.  
  314.                There are five chapters in this supplement.  Here is what
  315.                you'll find in each:
  316.  
  317.                Chapter 1 / Installation
  318.  
  319.                     This chapter explains how to install 4OS2.  Because the
  320.                     installation instructions vary depending on the version
  321.                     of OS/2 that you are using, everyone should read this
  322.                     short chapter.
  323.  
  324.                Chapter 2 / General Concepts
  325.  
  326.                     OS/2 is a rich operating system with a wide range of
  327.                     features.  We don't have the space for a complete OS/2
  328.                     tutorial, but some of the concepts and terms you need to
  329.                     configure and make full use of 4OS2 are explained in this
  330.  
  331.  
  332.           ___________________________________________________________________
  333.           Copyright 1992, JP Software Inc.        4OS2 Reference Manual  /  2
  334.  
  335.                                                                  INTRODUCTION
  336.           ___________________________________________________________________
  337.  
  338.  
  339.                     chapter.  Even if you are an experienced OS/2 user, we
  340.                     encourage you to read Chapter 2 before using 4OS2
  341.                     extensively.
  342.  
  343.                Chapter 3 / Using 4OS2
  344.  
  345.                     This chapter explains the differences between 4DOS and
  346.                     4OS2.  It is meant to be used as a supplement to Chapter
  347.                     5 / Using 4DOS in the 4DOS Reference Manual.
  348.  
  349.                Chapter 4 / Options and Tuning
  350.  
  351.                     This chapter discusses how to configure 4OS2.  It also
  352.                     explains how to configure 4DOS to run most efficiently as
  353.                     the command processor for DOS sessions under OS/2.
  354.  
  355.                Chapter 5 / Command Reference
  356.  
  357.                     The final chapter provides the details about the commands
  358.                     which are new in 4OS2 and about those which differ from
  359.                     4DOS.  It is meant to be used as a supplement to Chapter
  360.                     8 / 4DOS Command Reference in the 4DOS Reference Manual.
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.           ___________________________________________________________________
  390.           Copyright 1992, JP Software Inc.        4OS2 Reference Manual  /  3
  391.  
  392.                                                      CHAPTER 1 / INSTALLATION
  393.           ___________________________________________________________________
  394.  
  395.  
  396.  
  397.           CHAPTER 1 / INSTALLATION
  398.  
  399.  
  400.           Before you install 4OS2 (or any other software, for that matter),
  401.           you should make a bootable system diskette so you can recover in
  402.           case of a power failure or other interruption during the
  403.           installation process.  The easiest way to do so is to create a
  404.           bootable DOS system disk (see page 13 of the 4DOS reference
  405.           manual).  If necessary, you can use your OS/2 installation disks to
  406.           boot your system, then exit the installation program at the first
  407.           opportunity and return to an OS/2 (CMD.EXE) command prompt.
  408.  
  409.           Installing 4OS2
  410.  
  411.                See the sections below for specific instructions on installing
  412.                4OS2 manually under OS/2 version 1.x, or manually under OS/2
  413.                version 2.0.
  414.  
  415.                Once you have 4OS2 installed, the standard "OS/2 Window" and
  416.                "OS/2 Full Screen" selections in your Group-Main window (OS/2
  417.                version 1.x) or Command Prompts folder (OS/2 version 2.0) will
  418.                start 4OS2 instead of CMD.EXE (unless they have been changed
  419.                from their default configuration).  You may wish to change the
  420.                names of these selections to "4OS2 Window" and "4OS2 Full
  421.                Screen".
  422.  
  423.                If you have a STARTUP.CMD batch file, OS/2 will create a 4OS2
  424.                session at boot time and pass the STARTUP.CMD command to that
  425.                session, just as it did with CMD.EXE before 4OS2 was
  426.                installed.
  427.  
  428.                For information about creating additional 4OS2 icons,
  429.                configuring 4OS2, and setting up startup batch files for
  430.                specific 4OS2 sessions, see pages 12 and 26.
  431.  
  432.  
  433.           Manual 4OS2 Installation
  434.  
  435.                For this special shareware pre-release version the 4OS2 files
  436.                are contained in a ZIP or other similar compressed file which
  437.                you downloaded.  Extract these files onto your hard disk.
  438.                Place the files in their own directory.  In the examples
  439.                below, we have assumed that the files are in the C:\4OS2
  440.                directory.
  441.  
  442.                Once you have extracted the files, you can test drive 4OS2
  443.                before completing the installation.  To do so, start an OS/2
  444.                windowed or full-screen session from the Presentation Manager
  445.  
  446.           ___________________________________________________________________
  447.           Copyright 1992, JP Software Inc.        4OS2 Reference Manual  /  4
  448.  
  449.                                                      CHAPTER 1 / INSTALLATION
  450.           ___________________________________________________________________
  451.  
  452.  
  453.                desktop.  At the CMD.EXE prompt, change to the directory where
  454.                4OS2 is installed, and enter the command 4OS2.  When you're
  455.                ready to finish the installation process, follow the
  456.                instructions in the appropriate section below.  Before you
  457.                modify CONFIG.SYS, be sure you have a bootable floppy disk as
  458.                discussed above.
  459.  
  460.  
  461.                Manual Installation for OS/2 Version 1.x
  462.  
  463.                Use an ASCII-format editor to load and edit your OS/2
  464.                CONFIG.SYS file.  In the file, you will find a line that
  465.                begins with the word PROTSHELL and another that begins with
  466.                the words SET COMSPEC.  The lines should look something like
  467.                this, but they may not be adjacent in the file (the PROTSHELL
  468.                command is all on one line):
  469.  
  470.                     PROTSHELL=C:\OS2\PMSHELL.EXE C:\OS2\OS2.INI
  471.                          C:\OS2\OS2SYS.INI C:\OS2\CMD.EXE
  472.                     SET COMSPEC=C:\OS2\CMD.EXE
  473.  
  474.                Change the last item on the PROTSHELL line, the item that
  475.                includes the filename CMD.EXE, to point to 4OS2.EXE.  Be sure
  476.                to include the full path for 4OS2.EXE.  The changed PROTSHELL
  477.                line should look something like this (it should all be on one
  478.                line):
  479.  
  480.                     PROTSHELL=C:\OS2\PMSHELL.EXE C:\OS2\OS2.INI
  481.                          C:\OS2\OS2SYS.INI C:\4OS2\4OS2.EXE
  482.  
  483.                Do not change PMSHELL.EXE to 4OS2.EXE.  Change only the name
  484.                and path of CMD.EXE.
  485.  
  486.                Now change the SET COMSPEC line so that it also contains the
  487.                full path of 4OS2.EXE.  The completed line should look like
  488.                this:
  489.  
  490.                     SET COMSPEC=C:\4OS2\4OS2.EXE
  491.  
  492.                Verify that the changes have been made correctly and then save
  493.                the CONFIG.SYS file.  Exit from your editor and then reboot
  494.                your system.
  495.  
  496.                Manual Installation for OS/2 Version 2.0
  497.  
  498.                Use an ASCII-format editor to load and edit your OS/2
  499.                CONFIG.SYS file.  In the file, you will find a line that
  500.                begins with the words SET OS2_SHELL and another that begins
  501.  
  502.  
  503.           ___________________________________________________________________
  504.           Copyright 1992, JP Software Inc.        4OS2 Reference Manual  /  5
  505.  
  506.                                                      CHAPTER 1 / INSTALLATION
  507.           ___________________________________________________________________
  508.  
  509.  
  510.                with the words SET COMSPEC.  The lines should look something
  511.                like this, but they may not be adjacent in the file:
  512.  
  513.                     SET OS2_SHELL=D:\OS2\CMD.EXE
  514.                     SET COMSPEC=D:\OS2\CMD.EXE
  515.  
  516.                Change both of these lines so that they to point to 4OS2.EXE,
  517.                including its path, instead of to the CMD.EXE file.  When you
  518.                are done, the lines should look something like this:
  519.  
  520.                     SET OS2_SHELL=C:\4OS2\4OS2.EXE
  521.                     SET COMSPEC=C:\4OS2\4OS2.EXE
  522.  
  523.                Verify that the changes have been made correctly and then save
  524.                the CONFIG.SYS file.  Exit from your editor and then reboot
  525.                your system.
  526.  
  527.  
  528.           Uninstalling 4OS2
  529.  
  530.                In the extremely unlikely event that you have trouble with
  531.                your computer after you install 4OS2, you can remove it quite
  532.                easily.  We don't expect you to have any trouble, but we know
  533.                some people feel more secure knowing how to uninstall a
  534.                product as well as install it.  Or, you may need to remove
  535.                4OS2 from one system if you are moving it to another system.
  536.  
  537.                To temporarily remove 4OS2 from you system, use an ASCII
  538.                editor to edit your OS/2 CONFIG.SYS file.  You will need to
  539.                edit both the SET COMSPEC line (all versions of OS/2) and
  540.                either the PROTSHELL line (OS/2 version 1.x) or SET OS2_SHELL
  541.                line (OS/2 version 2.0).  In all cases, change the reference
  542.                to 4OS2.EXE to the complete path and filename of CMD.EXE.
  543.                Save the file, exit from your editor, shut down OS/2, and
  544.                reboot your system.  OS/2 will boot using CMD.EXE as its
  545.                command processor.
  546.  
  547.                To permanently remove 4OS2, follow the instructions above.
  548.                You will also want to change or delete any Group Main
  549.                selections (in OS/2 version 1.x) or icons (in OS/2 version
  550.                2.0) that refer directly to 4OS2.EXE.  Then delete all 4OS2
  551.                files on your hard drive to completely uninstall 4OS2.
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.           ___________________________________________________________________
  561.           Copyright 1992, JP Software Inc.        4OS2 Reference Manual  /  6
  562.  
  563.                                                  CHAPTER 2 / GENERAL CONCEPTS
  564.           ___________________________________________________________________
  565.  
  566.  
  567.  
  568.           CHAPTER 2 / GENERAL CONCEPTS
  569.  
  570.  
  571.           This chapter contains information about OS/2 and 4OS2.  Some of the
  572.           information is general and introductory in nature;  other parts of
  573.           this chapter are fairly detailed and technical.  We encourage you
  574.           to at least scan through this chapter to see what is here and to
  575.           study the sections that appear to have relevance to your way of
  576.           using 4OS2 and OS/2.
  577.  
  578.           Terminology
  579.  
  580.                Throughout this manual, the term "desktop" refers to the
  581.                Presentation Manager in OS/2 version 1.x or the Workplace
  582.                Shell in OS/2 version 2.0.
  583.  
  584.                The term "icon" refers to a selectable item on your desktop,
  585.                whether or not the corresponding icon is actually visible (you
  586.                may have chosen to configure the desktop with only session
  587.                names visible, rather than the icons themselves).  For
  588.                example, the standard desktop for all versions of OS/2
  589.                includes icons titled "OS/2 Windowed" and "OS/2 Full-Screen".
  590.  
  591.                The term "session" refers to the OS/2 session created by
  592.                selecting an icon on the desktop.  Sessions are used to run a
  593.                program or sequence of programs.  See below for more
  594.                information on sessions and session types.  When you double-
  595.                click on an icon or select it with the keyboard and press
  596.                Enter, a new session is started.
  597.  
  598.                The term "process" refers to a single invocation of a
  599.                particular program within a session.  Many sessions run only a
  600.                single process.  However, multiple processes can run
  601.                simultaneously within the same session.  For example, in a
  602.                4OS2 session which uses a pipe to send the output of one
  603.                program to the input of another, two processes run
  604.                simultaneously:  the program generating the output and the
  605.                program receiving it.
  606.  
  607.  
  608.           OS/2 Sessions and Applications
  609.  
  610.                OS/2 supports several different types of applications and many
  611.                methods for starting them.  Most of the time, you don't need
  612.                to worry about these differences because 4OS2 and OS/2 itself
  613.                cooperate to take care of them for you.  You may, however,
  614.                find this general discussion of applications and sessions
  615.                useful to understand what happens when you enter a command to
  616.  
  617.           ___________________________________________________________________
  618.           Copyright 1992, JP Software Inc.        4OS2 Reference Manual  /  7
  619.  
  620.                                                  CHAPTER 2 / GENERAL CONCEPTS
  621.           ___________________________________________________________________
  622.  
  623.  
  624.                run an application or other external program.  If you need
  625.                more details, see the OS/2 online reference information.
  626.  
  627.                Technical experts will recognize that these explanations are
  628.                not precise, but they should serve as a useful introduction
  629.                for many users.  (For example, this introduction does not
  630.                explore the distinction between sessions and screen groups.)
  631.  
  632.  
  633.                Sessions and Session Types
  634.  
  635.                OS/2 programs are run in "sessions" which are programs or
  636.                groups of programs whose output typically appears in specific
  637.                windowed display areas on the desktop ("windowed" sessions) or
  638.                takes up the whole screen ("full screen" sessions).
  639.  
  640.                A windowed session runs in a graphical window whose size you
  641.                (or an OS/2 application) can change.  As a result, portions of
  642.                the session's display area may be covered or invisible at any
  643.                given time.  The "active" session, or the session which may
  644.                receive keystrokes, is always shown with a highlighted title
  645.                bar.
  646.  
  647.                Full-screen sessions run on a standard text mode display,
  648.                generally 80 characters by 25 lines.  When such a session is
  649.                active, its full display area is visible and it hides all
  650.                other sessions and the desktop itself.  You can use the Alt-
  651.                Esc key to switch back to the desktop from a full-screen
  652.                session.
  653.  
  654.                OS/2 supports ten different types of sessions:
  655.  
  656.                     OS/2 Presentation Manager (PM) session:  A PM session
  657.                     runs in graphics mode on the desktop.  PM sessions are
  658.                     always windowed.  Their output is graphical and may
  659.                     include pictures and text in a variety of fonts within
  660.                     the same window.  Examples of PM sessions include those
  661.                     started to view the OS/2 command reference, or to run the
  662.                     Enhanced Editor distributed with OS/2.
  663.  
  664.                     OS/2 character mode, full-screen session:  This session
  665.                     type displays only text in character mode, like a
  666.                     standard DOS application.  It uses the entire screen,
  667.                     almost always in standard 80 x 25 text mode.  Examples
  668.                     include a 4OS2 or CMD.EXE full-screen session.
  669.  
  670.                     OS/2 character mode, windowed session:  This session type
  671.                     is just like the character mode full-screen session
  672.                     except that it runs in a window.  It uses the same text
  673.  
  674.           ___________________________________________________________________
  675.           Copyright 1992, JP Software Inc.        4OS2 Reference Manual  /  8
  676.  
  677.                                                  CHAPTER 2 / GENERAL CONCEPTS
  678.           ___________________________________________________________________
  679.  
  680.  
  681.                     font over the entire window and does not display
  682.                     graphics.    Examples include a 4OS2 or CMD.EXE windowed
  683.                     session.
  684.  
  685.                     DOS full-screen session:  A DOS session runs DOS within
  686.                     OS/2.  A special version of DOS, designed to run in such
  687.                     a session, is supplied with OS/2 and is generally
  688.                     compatible with MS-DOS 5.0.  A DOS full-screen session
  689.                     has full control of the screen (including the ability to
  690.                     switch it into graphics and non-standard text modes).  In
  691.                     OS/2 version 1.x, you can start exactly one DOS session,
  692.                     called the "DOS compatibility box."  Once this session is
  693.                     started, it cannot be closed (although you can switch
  694.                     back to the desktop with Alt-Esc).  In OS/2 version 2.0,
  695.                     you can start many such sessions, which are called
  696.                     Virtual DOS Machines (VDMs).  VDMs can be terminated with
  697.                     the EXIT command.  One example of a DOS full-screen
  698.                     session is the session started by the default "DOS full-
  699.                     screen" icon which is installed automatically with OS/2.
  700.  
  701.                     DOS windowed session:  Available only in OS/2 version
  702.                     2.0, this session is similar to a DOS full-screen
  703.                     session.  However, it runs in a window on the desktop and
  704.                     can be resized.  Such a session always runs as a VDM and
  705.                     can be terminated with the EXIT command.  You can switch
  706.                     a windowed DOS session into full-screen mode or back to a
  707.                     window by pressing Alt-Home.  A DOS windowed session can
  708.                     run all text-mode DOS applications, and certain
  709.                     applications which display graphics in standard graphics
  710.                     video modes.
  711.  
  712.                     Native DOS full-screen session:  Native DOS sessions are
  713.                     only available in OS/2 version 2.0.  They are similar to
  714.                     the DOS sessions described above, but load a specific
  715.                     version of DOS (for example, MS-DOS 3.3) into a VDM,
  716.                     rather than the version of DOS shipped with OS/2 version
  717.                     2.0.  Like normal DOS sessions, native DOS sessions can
  718.                     be switched between full-screen and windowed mode by
  719.                     pressing Alt-Home.  Once a native DOS session is started
  720.                     it cannot be terminated with the EXIT command.  The only
  721.                     way to terminate such a session is to switch it to
  722.                     windowed mode, bring up the system menu for the window,
  723.                     click Close, and then click Yes to the following prompt.
  724.                     For more information on native DOS sessions, see the
  725.                     command VMDISK and the topic "Starting a Specific Version
  726.                     of DOS" in the on-line Command Reference for OS/2 version
  727.                     2.0.
  728.  
  729.  
  730.  
  731.           ___________________________________________________________________
  732.           Copyright 1992, JP Software Inc.        4OS2 Reference Manual  /  9
  733.  
  734.                                                  CHAPTER 2 / GENERAL CONCEPTS
  735.           ___________________________________________________________________
  736.  
  737.  
  738.  
  739.                     Native DOS windowed session:  This session is similar to
  740.                     a native DOS full-screen session, but it runs in a window
  741.                     on the desktop instead of in full-screen mode.
  742.  
  743.                     Windows full-screen session:  This session type is
  744.                     available only in OS/2 version 2.0.  A Windows full-
  745.                     screen session is essentially a DOS full-screen session
  746.                     that is running the special version of Microsoft Windows
  747.                     that is supplied with OS/2 version 2.0.  It has the
  748.                     standard Windows display, the Program Manager and Control
  749.                     Panel, etc., and can run Windows applications, but it
  750.                     cannot start OS/2 or DOS applications.
  751.  
  752.                     WIN-OS/2 full-screen session:  This session type is
  753.                     available only in OS/2 version 2.0.  It is similar to a
  754.                     Windows full-screen session, but runs only a single
  755.                     application.
  756.  
  757.                     WIN-OS/2 windowed session:  This session type is
  758.                     available only in OS/2 version 2.0.  It allows a single
  759.                     Windows application to run inside a window on the
  760.                     Workplace Shell desktop without loading the Windows
  761.                     Program Manager.  Internally, it starts a DOS session and
  762.                     tells DOS to load the special version of Windows that
  763.                     comes with OS/2.  However, no DOS character-mode window
  764.                     is opened for this session -- only a graphical
  765.                     Presentation Manager window for the Windows application.
  766.                     This session type is sometimes called a "seamless
  767.                     Windows" session.
  768.  
  769.  
  770.                Applications and Application Types
  771.  
  772.                OS/2 and 4OS2 support six different types of applications.
  773.                Application types are related to the type of session in which
  774.                the application can run.  They are similar to, but not the
  775.                same as, session types.  The type of an application is
  776.                determined by the programmer when the application is created.
  777.                Information about the application type is embedded in the
  778.                application itself.
  779.  
  780.                The application types are:
  781.  
  782.                     OS/2 Presentation Manager application:  Runs in a PM
  783.                     session only.  Examples include the OS/2 online help
  784.                     program VIEW.EXE and the PM Chart utility distributed
  785.                     with OS/2.
  786.  
  787.  
  788.           ___________________________________________________________________
  789.           Copyright 1992, JP Software Inc.       4OS2 Reference Manual  /  10
  790.  
  791.                                                  CHAPTER 2 / GENERAL CONCEPTS
  792.           ___________________________________________________________________
  793.  
  794.  
  795.  
  796.                     OS/2 character mode, full-screen application:  Runs in a
  797.                     full-screen OS/2 session only.  Applications of this type
  798.                     are very rare.
  799.  
  800.                     OS/2 character mode, window-compatible application:  Runs
  801.                     in a full-screen or windowed OS/2 session.  Most OS/2
  802.                     character-mode applications -- including 4OS2 -- are in
  803.                     this category.  This and the previous type are sometimes
  804.                     called "VIO" or "AVIO" applications.
  805.  
  806.                     DOS application:  Runs in a DOS session only.  Examples
  807.                     include all .COM and .EXE files designed to run under
  808.                     DOS, such as those for your DOS communications program or
  809.                     word processor.  Virtually all DOS application programs
  810.                     that use text displays will run in either a full-screen
  811.                     or windowed DOS session.  Many DOS applications which use
  812.                     graphics will run properly only in a full-screen DOS
  813.                     session.  4OS2 recognizes DOS batch files with a .BAT
  814.                     extension as DOS applications.
  815.  
  816.                     "Bound application" or "Family-mode application":  Runs
  817.                     in an OS/2 or a DOS character mode session from the same
  818.                     .EXE file.  Bound applications are primarily used in
  819.                     compilers and installation programs to allow the same
  820.                     file to run under both DOS and OS/2.
  821.  
  822.                     Windows application:  Runs only in a Windows session.
  823.                     Examples include applications like Word for Windows and
  824.                     Corel Draw.  Most Windows applications will run properly
  825.                     in either a Windows full-screen session or a WIN-OS/2
  826.                     full-screen or windowed session.
  827.  
  828.  
  829.                Starting Sessions and Applications
  830.  
  831.                Before you can start an application program to do some work,
  832.                you must have a session in which to execute it.  Every icon on
  833.                the OS/2 desktop represents a potential session:  if you
  834.                double-click the icon or select it and press Enter, OS/2
  835.                starts a new session with the parameters which have been set
  836.                up for that icon.
  837.  
  838.                The parameters for the icon may cause the session to run an
  839.                OS/2 application program, load the OS/2 command processor
  840.                (CMD.EXE by default, or 4OS2 if you have it installed) and
  841.                display a prompt, run a batch file which could in turn start
  842.                other sessions, or start DOS, Windows, or a Windows
  843.                application.
  844.  
  845.           ___________________________________________________________________
  846.           Copyright 1992, JP Software Inc.       4OS2 Reference Manual  /  11
  847.  
  848.                                                  CHAPTER 2 / GENERAL CONCEPTS
  849.           ___________________________________________________________________
  850.  
  851.  
  852.  
  853.                To start 4OS2, you must define an icon for an OS/2 character
  854.                mode session, either full-screen or windowed.  To do so, see
  855.                Chapter 4 / Options and Tuning (page 26) for full
  856.                instructions.  Briefly, after you have installed 4OS2 and
  857.                defined it as your shell in your CONFIG.SYS file, you merely
  858.                have to place an asterisk [*] in the field for the program
  859.                name.  You can also explicitly specify the full path and name
  860.                of 4OS2.EXE instead of using the [*] if CONFIG.SYS has not
  861.                been set up yet.
  862.  
  863.                Once 4OS2 has started, you can start applications or other
  864.                sessions from the 4OS2 prompt.  When you start an application,
  865.                4OS2 checks its type.  If the type is the same as that of the
  866.                session in which 4OS2 is running (which will only happen for
  867.                OS/2 character-mode applications), the application will run in
  868.                the same session as 4OS2, and 4OS2 will wait for the
  869.                application to complete before displaying a new prompt.  This
  870.                is analogous to how applications are run in DOS.
  871.  
  872.                If the application type is different from the 4OS2 session
  873.                type, 4OS2 will start a new session to run the application.
  874.                Then 4OS2 will wait for that session to signal completion
  875.                before returning to the prompt.  You can also force 4OS2 to
  876.                start a new session and not wait for it to complete by using
  877.                the START command (see page 46).
  878.  
  879.  
  880.           Creating and Configuring Icons
  881.  
  882.                This section gives you basic information which you will need
  883.                to create and configure 4OS2 and 4DOS icons on your OS/2
  884.                desktop.  For complete details on creating and configuring
  885.                icons, see your OS/2 documentation.  For details on the
  886.                appropriate properties or settings to use for 4OS2 and 4DOS
  887.                icons see pages 27 (4OS2) and 31 (4DOS).
  888.  
  889.                OS/2 Version 1.x Icons
  890.  
  891.                In OS/2 version 1.x icons are displayed within groups on the
  892.                desktop.  For example, the "OS/2 Full-screen" icon normally
  893.                appears in Group-Main.
  894.  
  895.                To create a new icon, switch to the group where you want the
  896.                icon to appear and choose the New selection on the File menu.
  897.                Then adjust the icon's properties.
  898.  
  899.                To adjust the properties of an icon, first select it (click on
  900.                the icon once, or use the arrow keys on the keyboard), then
  901.  
  902.           ___________________________________________________________________
  903.           Copyright 1992, JP Software Inc.       4OS2 Reference Manual  /  12
  904.  
  905.                                                  CHAPTER 2 / GENERAL CONCEPTS
  906.           ___________________________________________________________________
  907.  
  908.  
  909.                open the File Properties menu from the menu bar.  From within
  910.                this menu you can modify the program name, startup directory,
  911.                command line parameters, and other configuration data for the
  912.                icon.
  913.  
  914.  
  915.                OS/2 Version 2.0 Icons
  916.  
  917.                In OS/2 version 2.0, icons may appear on the desktop itself or
  918.                within folders.  For example, the "OS/2 Full-screen" icon
  919.                normally appears in the "Command Prompts" folder.
  920.  
  921.                To create a new icon, switch to the folder where you want the
  922.                icon to appear and either copy an existing icon (use either
  923.                the Copy or Create Another selection on the icon's popup menu)
  924.                or drag a Program Template in from the Templates folder.
  925.                Depending on the copying method you choose, the Settings
  926.                window may open automatically.
  927.  
  928.                To adjust the properties of an icon, you must open its
  929.                Settings window.  To do so, click the right mouse button in
  930.                the icon.  When the popup menu appears, click the left mouse
  931.                button on the small arrow to the right of the Open selection,
  932.                then again on the Settings selection on the submenu.
  933.  
  934.                Once the Settings window is open, use the Program notebook tab
  935.                to modify the program name, startup directory, and command
  936.                line parameters.  The Session tab lets you set the session
  937.                type.  Other tabs let you adjust other configuration data for
  938.                the icon.
  939.  
  940.                The contents of the Settings window will vary depending on the
  941.                type of icon and the session type set on the Session tab.  For
  942.                example, DOS and Windows sessions allow control of a wide
  943.                variety of DOS parameters (such as available XMS and EMS
  944.                memory, whether DOS is loaded high, or the maximum number of
  945.                open files) using the "DOS Settings" or "Windows Settings"
  946.                button.  However, this button cannot be used for Presentation
  947.                Manager or OS/2 character-mode sessions.
  948.  
  949.           Primary and Secondary Shells
  950.  
  951.                Primary and secondary shells are used a little differently
  952.                under OS/2 than you may be used to under DOS.  In particular,
  953.                primary shells are more common in OS/2 and secondary shells
  954.                are less common.
  955.  
  956.                When you boot DOS, there is only one primary shell:  the one
  957.                loaded when your system boots.  Under OS/2, a new primary
  958.  
  959.           ___________________________________________________________________
  960.           Copyright 1992, JP Software Inc.       4OS2 Reference Manual  /  13
  961.  
  962.                                                  CHAPTER 2 / GENERAL CONCEPTS
  963.           ___________________________________________________________________
  964.  
  965.  
  966.                shell starts whenever a new character-mode session is started
  967.                from the desktop.  If the session is an OS/2 session, a 4OS2
  968.                (or CMD.EXE) primary shell is used.  If it is a DOS or Windows
  969.                session, a 4DOS (or COMMAND.COM) primary shell is used.
  970.  
  971.                Secondary shells are used most often under DOS for "shelling
  972.                to DOS" from an application, and for starting DOS sessions
  973.                under multitaskers or task switchers like Back & Forth,
  974.                DESQview, or Microsoft Windows.  Most OS/2 applications don't
  975.                offer a "shell to DOS" capability, and new sessions create
  976.                primary, not secondary shells.  As a result, 4OS2 secondary
  977.                shells are generally created only for pipes (see page 19), or
  978.                when you start a second copy of 4OS2 directly from the command
  979.                prompt.
  980.  
  981.  
  982.           High Performance File System (HPFS)
  983.  
  984.                OS/2 version 2.0 includes support for two different file
  985.                systems.  The first is the traditional DOS file system that is
  986.                based on a file allocation table (FAT) and has file names that
  987.                are composed of 8 characters plus a 3-character extension.
  988.  
  989.                The second file system is called the High Performance File
  990.                System or HPFS.  In this system, file names can be a maximum
  991.                of 255 characters.  The names may include spaces and other
  992.                characters that are not allowed in the FAT file system.
  993.  
  994.                The file system type (FAT or HPFS) is determined when a hard
  995.                disk partition is formatted, and applies to the entire
  996.                partition.  For example, you might have a 200 MB hard disk
  997.                divided into four 50 MB partitions, with the first three
  998.                partitions (C:, D:, and E:) formatted for the FAT file system
  999.                and the fourth (F:) formatted for HPFS.  Partition F: would
  1000.                then be available only from OS/2 sessions (including DOS
  1001.                sessions running under OS/2).  It would not be visible from a
  1002.                normal DOS boot.
  1003.  
  1004.                4OS2 is compatible with both file systems.  Any command that
  1005.                accepts file names will accept both FAT-compatible names and
  1006.                HPFS-compatible names.  If an HPFS-compatible name includes
  1007.                spaces or other characters that would not be allowed in a FAT
  1008.                name, you must place quotation marks around the entire name.
  1009.  
  1010.                For example, suppose you have a file named LET3 on a FAT
  1011.                partition, and you want to copy it to the LETTERS directory on
  1012.                drive F:, an HPFS partition, and give it the name LETTER TO
  1013.                SARA.  To do so, use either of these commands:
  1014.  
  1015.  
  1016.           ___________________________________________________________________
  1017.           Copyright 1992, JP Software Inc.       4OS2 Reference Manual  /  14
  1018.  
  1019.                                                  CHAPTER 2 / GENERAL CONCEPTS
  1020.           ___________________________________________________________________
  1021.  
  1022.  
  1023.  
  1024.                     [c:\wp] copy let3 f:\"letter to sara"
  1025.                     [c:\wp] copy let3 "f:\letter to sara"
  1026.  
  1027.                Note that the quotes can include the filename only, or the
  1028.                entire path.  As long as the portion of the filename which
  1029.                includes spaces or other similar separator characters is
  1030.                quoted, the filename will be interpreted properly.
  1031.  
  1032.                HPFS is called an "installable file system" (installed with
  1033.                the IFS= directive in CONFIG.SYS).  OS/2 supports (but does
  1034.                not include) additional installable file systems.  4OS2 will
  1035.                work properly with any installable file system which supports
  1036.                standard OS/2 file access calls.
  1037.  
  1038.  
  1039.           Extended Attributes
  1040.  
  1041.                DOS allows you to define a limited set of attributes for
  1042.                files, for example whether the file is Read-Only, Hidden, or
  1043.                System (for more information see pages 47 - 48 of the 4DOS
  1044.                manual).  OS/2 supports a new type of information about files
  1045.                called "Extended Attributes" or "EAs".
  1046.  
  1047.                The Extended Attributes for a file provide additional
  1048.                information about the file which is not part of the file's
  1049.                actual contents.  This information might include the icon to
  1050.                be displayed for the file on the OS/2 desktop or the type of
  1051.                data contained in the file.
  1052.  
  1053.                Extended Attributes are supported for both FAT and HPFS disk
  1054.                volumes.  EAs for the files on a particular drive are stored
  1055.                in the file "EA DATA. SF" in the drive's root directory.  Like
  1056.                CMD.EXE, 4OS2 preserves a file's EAs when copying or moving
  1057.                the file, and makes the appropriate adjustments to EAs when a
  1058.                file is deleted or renamed.
  1059.  
  1060.                4DOS cannot access Extended Attributes, and will not preserve
  1061.                them or adjust the EA file when files are copied, moved,
  1062.                deleted, or renamed.  Therefore you should be sure to use 4OS2
  1063.                rather than 4DOS to manipulate files which have EAs.
  1064.  
  1065.                For more information on Extended Attributes, see your OS/2
  1066.                documentation.
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.           ___________________________________________________________________
  1074.           Copyright 1992, JP Software Inc.       4OS2 Reference Manual  /  15
  1075.  
  1076.                                                        CHAPTER 3 / USING 4OS2
  1077.           ___________________________________________________________________
  1078.  
  1079.  
  1080.  
  1081.           CHAPTER 3 / USING 4OS2
  1082.  
  1083.  
  1084.                In use, 4OS2 is nearly identical to 4DOS.  The few differences
  1085.                are explained in this chapter.  We have assumed in this
  1086.                chapter that you have the 4DOS Reference Manual available and
  1087.                that you have some familiarity with the corresponding 4DOS
  1088.                features.
  1089.  
  1090.                If a section of this chapter seems completely unfamiliar to
  1091.                you, it is probably discussing a feature of 4DOS and 4OS2
  1092.                which you are not using.  Feel free to read only the sections
  1093.                of this chapter that are relevant to the way that you use your
  1094.                computer and 4OS2.
  1095.  
  1096.           At the Command Line
  1097.                  [see page 55 in the 4DOS Reference Manual]
  1098.  
  1099.                For compatibility with CMD.EXE, the 4OS2 command line will
  1100.                hold a maximum of 299 characters, instead of the 255
  1101.                characters available at the 4DOS command line.  All other
  1102.                command line editing features work the same under 4OS2 as they
  1103.                do under 4DOS.
  1104.  
  1105.                The default 4OS2 prompt is [$p] on hard disk partitions and
  1106.                [$n] on floppy disks, rather than the corresponding defaults
  1107.                of $p$g and $n$g in 4DOS.  This default is compatible with
  1108.                CMD.EXE, and encloses the current path or drive in square
  1109.                brackets.  When OS/2 is installed it inserts a SET PROMPT
  1110.                statement in CONFIG.SYS to set the prompt to $i[$p] .  This
  1111.                prompt will override 4OS2's default (it will not affect 4DOS).
  1112.                It adds a header line to the default prompt, to remind you of
  1113.                certain OS/2 keystrokes.  You can modify or delete the SET
  1114.                PROMPT line in CONFIG.SYS if you want to use a different
  1115.                prompt for your 4OS2 sessions.
  1116.  
  1117.  
  1118.                4OS2 HELP
  1119.  
  1120.                Complete on-line help for all 4OS2 commands and features is
  1121.                provided with 4OS2.  As in 4DOS, help is invoked with the HELP
  1122.                command or the F1 key.  However, the 4OS2 help does not cover
  1123.                the OS/2 external commands because they are included in OS/2's
  1124.                general help.
  1125.  
  1126.                When you start the 4OS2 Help system, 4OS2 opens a new OS/2
  1127.                Presentation Manager session to run VIEW.EXE, the standard
  1128.  
  1129.  
  1130.           ___________________________________________________________________
  1131.           Copyright 1992, JP Software Inc.       4OS2 Reference Manual  /  16
  1132.  
  1133.                                                        CHAPTER 3 / USING 4OS2
  1134.           ___________________________________________________________________
  1135.  
  1136.  
  1137.                help program supplied with OS/2.  VIEW displays the 4OS2 Help
  1138.                information and lets you browse through it.
  1139.  
  1140.                If you invoke VIEW from a windowed 4OS2 session, you will be
  1141.                returned to that session when you are done with VIEW.  If you
  1142.                invoke VIEW from a full-screen session, you must manually
  1143.                return to that session using standard OS/2 methods for
  1144.                switching between sessions.
  1145.  
  1146.                You can also keep the VIEW help window on the screen and
  1147.                return to the 4OS2 session, switching between the two sessions
  1148.                as needed.  This may be useful when you are writing a batch
  1149.                file, working on a complex command, or experimenting with
  1150.                4OS2.
  1151.  
  1152.                See page 30 for information about configuring 4OS2 help.
  1153.  
  1154.  
  1155.                Shared History and Alias Lists
  1156.                  [see pages 57 and 94 in the 4DOS Reference Manual]
  1157.  
  1158.                By default, 4OS2 will use the same history list and alias list
  1159.                in all sessions and in both primary and secondary 4OS2 shells.
  1160.                It keeps these lists in shared memory segments.  This means
  1161.                that the aliases that you define in one session will
  1162.                immediately be available in copies of 4OS2 that are running in
  1163.                other sessions.  In addition, the history list, which is used
  1164.                to record the commands that you type, is updated in all 4OS2
  1165.                sessions whenever you type a command at any 4OS2 prompt.
  1166.  
  1167.                If you want to start a 4OS2 shell or session with unique alias
  1168.                and history lists, use the LocalLists directive in the
  1169.                4OS2.INI file (see page 29) or //LocalLists on the 4OS2
  1170.                command line (see page 27).  Using the 40S2.INI directive is
  1171.                the best choice if you want to have separate alias and history
  1172.                lists for all 4OS2 sessions.  You might prefer using the
  1173.                command line directive if you want to create a separate list
  1174.                just for one particular session or shell.
  1175.  
  1176.                The memory segments that contain the shared history and alias
  1177.                lists are retained as long as there is at least one copy of
  1178.                4OS2 running that supports shared lists.  When all such copies
  1179.                of 4OS2 end, the shared history and alias lists are discarded.
  1180.  
  1181.                A utility program called SHRALIAS.EXE is included on the 4OS2
  1182.                distribution diskette.  It will keep these lists open until
  1183.                your computer is rebooted.  To use this program, include the
  1184.                following line in your STARTUP.CMD, 4START, or 4OS2 session
  1185.                startup batch file:
  1186.  
  1187.           ___________________________________________________________________
  1188.           Copyright 1992, JP Software Inc.       4OS2 Reference Manual  /  17
  1189.  
  1190.                                                        CHAPTER 3 / USING 4OS2
  1191.           ___________________________________________________________________
  1192.  
  1193.  
  1194.  
  1195.                     [d:\path\]shralias
  1196.  
  1197.                Once SHRALIAS is started it will remain active until your
  1198.                computer is turned off or rebooted, even if the session from
  1199.                which it was started is terminated.  To deactivate SHRALIAS,
  1200.                enter this command at any 4OS2 prompt:
  1201.  
  1202.                     [d:\path]shralias /u
  1203.  
  1204.  
  1205.                Multiple Commands
  1206.                  [see page 62 in the 4DOS Reference Manual]
  1207.  
  1208.                In order to maintain compatibility with CMD.EXE, the default
  1209.                command separator in 4OS2 is the ampersand [&].  You may
  1210.                select a different symbol with the CommandSep directive in the
  1211.                4OS2.INI file or the SETDOS /C command.
  1212.  
  1213.                If you want to share batch (.BTM) files between 4OS2 and 4DOS,
  1214.                you will probably want to select the same command separator
  1215.                for both programs.
  1216.  
  1217.                Escape Character
  1218.  
  1219.                  [see page 91 in the 4DOS Reference Manual]
  1220.  
  1221.                In order to maintain compatibility with CMD.EXE, the default
  1222.                escape character in 4OS2 is the caret [^].  You may select a
  1223.                different symbol with the EscapeChar directive in the 4OS2.INI
  1224.                file or the SETDOS /E command.
  1225.  
  1226.                If you want to share batch (.BTM) files between 4OS2 and 4DOS,
  1227.                you will probably want to select the same escape character for
  1228.                both programs.
  1229.  
  1230.           Redirection
  1231.                  [see page 66 in the 4DOS Reference Manual]
  1232.  
  1233.                In addition to the extended 4DOS redirection options, 4OS2
  1234.                also the supports the OS/2 (CMD.EXE) syntax
  1235.  
  1236.                          n>
  1237.  
  1238.                and
  1239.  
  1240.                          >n
  1241.  
  1242.  
  1243.  
  1244.           ___________________________________________________________________
  1245.           Copyright 1992, JP Software Inc.       4OS2 Reference Manual  /  18
  1246.  
  1247.                                                        CHAPTER 3 / USING 4OS2
  1248.           ___________________________________________________________________
  1249.  
  1250.  
  1251.  
  1252.                where [n] is a digit between 0 and 9.  The n> syntax redirects
  1253.                standard output to handle n;  >n redirects handle n to
  1254.                standard output.  By definition, OS/2 interprets "0" as
  1255.                standard input, "1" as standard output, and "2" as standard
  1256.                error.  Digits 3 through 9 can be defined (and redefined) by
  1257.                individual application programs.
  1258.  
  1259.  
  1260.           Piping
  1261.                  [see page 68 in the 4DOS Reference Manual]
  1262.  
  1263.                A pipe takes the standard output of one program (the sending
  1264.                program) and uses it as the standard input of a second program
  1265.                (the receiving program).  Because of the limitations of MS-
  1266.                DOS, 4DOS implements pipes by creating a temporary file to
  1267.                collect the output from the sending program.  Once that
  1268.                program is done, 4DOS starts the receiving program and sends
  1269.                it the contents of the temporary file as its input.  When the
  1270.                receiving program ends, 4DOS deletes the temporary file.
  1271.  
  1272.                The flexibility of OS/2 lets 4OS2 implement pipes by starting
  1273.                a new process for the receiving program.  The sending and
  1274.                receiving programs run simultaneously;  the sending program
  1275.                writes to the pipe and the receiving program reads from the
  1276.                pipe.  When both programs finish, the process for the
  1277.                receiving program is automatically ended.
  1278.  
  1279.                If you are used to using pipes under 4DOS, you normally will
  1280.                not see any difference with a 4OS2 pipe except perhaps less
  1281.                disk activity.  But you may not get the results you expect
  1282.                from 4OS2 if you use a pipe command like
  1283.  
  1284.                          [c:\]echo test | input %%var
  1285.  
  1286.                In 4DOS, this pipe will create an environment variable called
  1287.                VAR and set its value as "test."  You will be able to see the
  1288.                new variable by typing SET at the 4DOS command.
  1289.  
  1290.                In 4OS2, VAR will be set in the environment that belongs to
  1291.                the receiving program.  But that environment will be discarded
  1292.                when the pipe has been emptied and the process ends.  You will
  1293.                never see VAR in the environment even though 4OS2 and OS/2 are
  1294.                both operating correctly.
  1295.  
  1296.                The same cautions apply to the "pipe-fitting" commands, TEE
  1297.                and Y.  When you use pipes with 4OS2, make sure you think
  1298.                about any possible consequences that can occur from using a
  1299.                separate process to run the receiving program.
  1300.  
  1301.           ___________________________________________________________________
  1302.           Copyright 1992, JP Software Inc.       4OS2 Reference Manual  /  19
  1303.  
  1304.                                                        CHAPTER 3 / USING 4OS2
  1305.           ___________________________________________________________________
  1306.  
  1307.  
  1308.  
  1309.  
  1310.           4OS2 Internal Variables
  1311.                  [see page 79 in the 4DOS Reference Manual]
  1312.  
  1313.                The following internal variables are unique to 4OS2:
  1314.                     _PID is the current process ID number.
  1315.  
  1316.                     _PPID is the process ID number of the parent process.
  1317.                     _SID is the session ID number.
  1318.  
  1319.                     _PTYPE is the current OS/2 process type:
  1320.                          AVIO      Character mode, windowed
  1321.                          DT        Detached (no screen in use)
  1322.                          FS        Character mode, full-screen
  1323.                          PM        Presentation Manager
  1324.  
  1325.                The following 4DOS internal variables are not available in
  1326.                4OS2:
  1327.  
  1328.                     _ALIAS (because 4OS2 dynamically sizes the alias list).
  1329.                     _DV (because DESQView does not run under OS/2).
  1330.  
  1331.                     _ENV (because the environment size is adjusted
  1332.                     dynamically by 4OS2).
  1333.                     _WIN (because Windows does not run in the OS/2 character-
  1334.                     mode sessions used to run 4OS2).
  1335.  
  1336.  
  1337.           4OS2 Variable Functions
  1338.                  [see page 83 in the 4DOS Reference Manual]
  1339.  
  1340.                The following variable functions are available only in 4OS2:
  1341.  
  1342.                     @EXETYPE[filename]:  Returns the application type as a
  1343.                     string:
  1344.                          DOS       DOS .COM, .EXE, or .BAT file (OS/2 2.0
  1345.                                    only)
  1346.                          AVIO      OS/2 Character-mode, windowed
  1347.                          FS        OS/2 Character mode, full-screen
  1348.                          PM        OS/2 Presentation Manager
  1349.                          WIN       Windows 3.x (OS/2 2.0 only)
  1350.  
  1351.                     @FSTYPE[d:]: Returns the file system type for the
  1352.                     specified drive.  Normally, it will return "FAT" for a
  1353.                     DOS-compatible drive with a file allocation table or
  1354.                     "HPFS" for a drive that uses OS/2's high performance file
  1355.                     system.  Other values may be returned by any additional
  1356.  
  1357.  
  1358.           ___________________________________________________________________
  1359.           Copyright 1992, JP Software Inc.       4OS2 Reference Manual  /  20
  1360.  
  1361.                                                        CHAPTER 3 / USING 4OS2
  1362.           ___________________________________________________________________
  1363.  
  1364.  
  1365.                     file systems installed with the IFS= directive in
  1366.                     CONFIG.SYS.
  1367.  
  1368.                The following 4DOS variable functions are not available in
  1369.                4OS2:
  1370.  
  1371.                     @EMS (because OS/2 does not recognize nor use expanded
  1372.                     memory).
  1373.                     @EXTENDED (because OS/2 does not recognize extended
  1374.                     memory as a special memory type).
  1375.  
  1376.                     @LPT (because there is no feasible way to read printer
  1377.                     status information directly under OS/2).
  1378.                     @REMOVABLE (because there is no feasible way to detect
  1379.                     removable drives under OS/2)
  1380.  
  1381.                     @TRUENAME (because there is no feasible way to detect
  1382.                     true names under OS/2).
  1383.                     @XMS (because OS/2 does not recognize nor use XMS
  1384.                     memory).
  1385.  
  1386.  
  1387.           Batch Files
  1388.  
  1389.                4OS2 can execute two kinds of batch files: files with an
  1390.                extension of .CMD and those with an extension of .BTM.  The
  1391.                former are traditional OS/2 batch files;  the latter can be
  1392.                run by 4OS2 and by 4DOS running either under DOS or in a DOS
  1393.                session under OS/2.
  1394.  
  1395.                If you run the same .BTM files with 4OS2 and 4DOS, you should
  1396.                encounter few difficulties.  However, 4OS2 and 4DOS by default
  1397.                use a different command separator and a different escape
  1398.                character.  You might want to use the CommandSep and
  1399.                EscapeChar directives in either 4OS2.INI or 4DOS.INI to set
  1400.                the same separator and escape character in both products (see
  1401.                page 18).
  1402.  
  1403.                Inside a .BTM file, you can use combinations of IF %_DOS and
  1404.                IF %_DOSVER, to determine whether the file is being executed
  1405.                by 4OS2, by 4DOS running under DOS, or by 4DOS in a DOS
  1406.                session under OS/2..  You can also use IF %_SHELL to determine
  1407.                whether the file is being executed by a primary or secondary
  1408.                shell in either environment.
  1409.  
  1410.                The template below should help you write .BTM files that can
  1411.                run successfully in each possible environment.  It includes
  1412.                detection of several different environments but does not cover
  1413.                all possibilities.  The basic rule is to use the internal
  1414.  
  1415.           ___________________________________________________________________
  1416.           Copyright 1992, JP Software Inc.       4OS2 Reference Manual  /  21
  1417.  
  1418.                                                        CHAPTER 3 / USING 4OS2
  1419.           ___________________________________________________________________
  1420.  
  1421.  
  1422.                variable %_DOS to determine the operating system, %_DOSVER to
  1423.                determine the operating system version, and %_SHELL to
  1424.                determine the shell level.  Note that in a DOS session
  1425.                %_DOSVER returns 3.3, 5.0, etc. for the corresponding MS-DOS
  1426.                versions, 10.2 or 10.3 for the OS/2 version 1.2 or 1.3 DOS
  1427.                Compatibility Box, and 20.0 for an OS/2 version 2.0 VDM.  In
  1428.                an OS/2 session %_DOSVER returns the true OS/2 version (e.g.
  1429.                1.2 or 2.0).
  1430.  
  1431.                     [commands here for both 4OS2 and 4DOS]
  1432.                     if "%_DOS" == "DOS" then
  1433.                          [commands here for all 4DOS shells]
  1434.                          iff %_DOSVER eq 20.0
  1435.                               [commands here for OS/2 2.0 VDMs]
  1436.                          endiff
  1437.                          iff %_SHELL == 0
  1438.                               [commands here for 4DOS primary shells]
  1439.                          endiff
  1440.                     else
  1441.                          [commands here for all 4OS2 shells]
  1442.                          iff %_DOSVER eq 1.3
  1443.                               [commands here for 4OS2 under OS/2 1.3]
  1444.                          elseiff %_DOSVER eq 2.0
  1445.                               [commands here for 4OS2 under OS/2 2.0]
  1446.                          endiff
  1447.                          iff %_SHELL ne 0
  1448.                               [commands here for all 4OS2 secondary shells]
  1449.                     endiff
  1450.  
  1451.  
  1452.                4OS2 Startup and Exit Files
  1453.  
  1454.                4OS2 uses three startup or exit batch files: STARTUP.CMD,
  1455.                4START, and 4EXIT.  The first is run automatically whenever
  1456.                OS/2 starts.  4START is run whenever 4OS2 starts, and 4EXIT is
  1457.                run whenever 4OS2 exits.  4START and 4EXIT can be either .CMD
  1458.                or .BTM files.  If they have an extension of .BTM, they will
  1459.                also run whenever 4DOS starts and exits if they are in a
  1460.                directory where 4DOS can find them.
  1461.  
  1462.                Using STARTUP.CMD
  1463.  
  1464.                If you have a STARTUP.CMD file in the root directory of your
  1465.                OS/2 boot drive, OS/2 will automatically create a windowed
  1466.                4OS2 session when the system boots and tell that session to
  1467.                execute STARTUP.CMD.
  1468.  
  1469.                You can use STARTUP.CMD to start other sessions, to set up a
  1470.                global alias list, etc., just as you might use AUTOEXEC.BAT
  1471.  
  1472.           ___________________________________________________________________
  1473.           Copyright 1992, JP Software Inc.       4OS2 Reference Manual  /  22
  1474.  
  1475.                                                        CHAPTER 3 / USING 4OS2
  1476.           ___________________________________________________________________
  1477.  
  1478.  
  1479.                under DOS.  STARTUP.CMD will be executed once, when your
  1480.                system boots, not every time a 4OS2 session is started.
  1481.  
  1482.                If you place the command EXIT at the end of STARTUP.CMD, the
  1483.                session will end when that command is executed, and any global
  1484.                alias list will be discarded if no other 4OS2 session has been
  1485.                started and SHRALIAS has not been loaded (see page 17).
  1486.                Otherwise, the session will remain open and can be used as a
  1487.                normal windowed 4OS2 session.
  1488.  
  1489.  
  1490.                Using 4START and 4EXIT
  1491.  
  1492.                If you create a 4START.BTM and 4EXIT.BTM file, you can use
  1493.                them for both 4OS2 and 4DOS.  The template above shows how to
  1494.                include commands that are specific to each operating system.
  1495.  
  1496.                If you prefer to use different files for 4OS2 and 4DOS, you
  1497.                can use 4START.CMD for 4OS2 and 4START.BAT for 4DOS.  You
  1498.                could name your 4EXIT files similarly.
  1499.  
  1500.                If you prefer, you can create a file with a name other than
  1501.                4START (for example, STARTOS2.CMD) and put its name in the
  1502.                Parameters field for any 4OS2 icon (see page 26).  Doing so
  1503.                has two advantages.  The file will only be started when a
  1504.                primary 4OS2 shell is started, not under a secondary shell or
  1505.                under 4DOS.  Also, you can then use different startup files
  1506.                for different 4OS2 sessions.  Note that this file will not be
  1507.                run by the "automatic" session that OS/2 starts at boot time
  1508.                to run STARTUP.CMD.  If you want it to run at that time also,
  1509.                you will have to CALL it from STARTUP.CMD.
  1510.  
  1511.                REXX Support
  1512.  
  1513.                REXX is a file and text processing language developed by IBM
  1514.                and included within OS/2.  REXX files have a .CMD extension,
  1515.                just like normal batch files, but the first two characters in
  1516.                the file are always [/*], which indicate the beginning of a
  1517.                REXX comment.
  1518.  
  1519.                4OS2 checks to see if the first two characters on the first
  1520.                line of a .CMD file are [/*].  If so, it passes the file to
  1521.                OS/2's built-in REXX facility for processing.  Any commands in
  1522.                the REXX file which are not recognized by REXX will be passed
  1523.                back to 4OS2.  This allows you to embed any valid 4OS2 command
  1524.                (including internal commands and aliases) within a REXX file
  1525.                which is started from 4OS2.  You can also force REXX to pass
  1526.                commands to 4OS2 by enclosing those commands in single
  1527.                quotation marks.
  1528.  
  1529.           ___________________________________________________________________
  1530.           Copyright 1992, JP Software Inc.       4OS2 Reference Manual  /  23
  1531.  
  1532.                                                        CHAPTER 3 / USING 4OS2
  1533.           ___________________________________________________________________
  1534.  
  1535.  
  1536.  
  1537.                For more information on REXX see your OS/2 documentation.
  1538.  
  1539.  
  1540.                EXTPROC Support
  1541.  
  1542.                OS/2 also offers an "external processor" (EXTPROC) option for
  1543.                batch files which lets you define an external program to
  1544.                process a particular .CMD file.
  1545.  
  1546.                4OS2 supports EXTPROC in the same way as CMD.EXE.  To identify
  1547.                a .CMD file to be used with an external processor, place the
  1548.                string "EXTPROC" as the first word on the first line of the
  1549.                file followed by the name of the external program which should
  1550.                be called.  4OS2 will start the program and pass it the name
  1551.                of the .CMD file and any command line arguments which were
  1552.                entered.  4OS2 will look for the external processor in the
  1553.                current directory and then in each directory in the PATH.
  1554.                4OS2 will start the external processor in the current session,
  1555.                if possible, and wait for it to finish.  If the external
  1556.                processor's application type is incompatible with the current
  1557.                session, 4OS2 will begin a new session for it and wait until
  1558.                that session ends before returning to the command prompt.
  1559.  
  1560.                For example, suppose GETDATA.CMD contains the following lines:
  1561.  
  1562.                     EXTPROC D:\DATAACQ\DATALOAD.EXE
  1563.                     OPEN PORT1
  1564.                     READ 4000
  1565.                     DISKWRITE D:\DATAACQ\PORT1\RAW
  1566.  
  1567.                Then if you entered the command:
  1568.  
  1569.                     [d:\dataacq>] getdata p17
  1570.  
  1571.                4OS2 would read the GETDATA.CMD file, determine that it began
  1572.                with an EXTPROC command, read the name of the processor
  1573.                program, and then execute the command:
  1574.  
  1575.                     D:\DATAACQ\DATALOAD.EXE D:\DATAACQ\GETDATA.CMD p17
  1576.  
  1577.                The hypothetical DATALOAD.EXE program would then be
  1578.                responsible for reopening the GETDATA.CMD file, ignoring the
  1579.                EXTPROC line at the start, and interpreting the other
  1580.                instructions in the file.  It would also have to respond
  1581.                appropriately to the command line parameter entered (p17).
  1582.  
  1583.                For more information on external batch file processors see
  1584.                your OS/2 documentation.
  1585.  
  1586.           ___________________________________________________________________
  1587.           Copyright 1992, JP Software Inc.       4OS2 Reference Manual  /  24
  1588.  
  1589.                                                        CHAPTER 3 / USING 4OS2
  1590.           ___________________________________________________________________
  1591.  
  1592.  
  1593.  
  1594.                Do not try to run 4OS2 or CMD.EXE as an external processor
  1595.                with EXTPROC.  Both programs will interpret the EXTPROC line
  1596.                as a command to re-open themselves.  The result will be an
  1597.                infinite loop that will continue until the computer runs out
  1598.                of resources and locks up.
  1599.  
  1600.  
  1601.  
  1602.  
  1603.  
  1604.  
  1605.  
  1606.  
  1607.  
  1608.  
  1609.  
  1610.  
  1611.  
  1612.  
  1613.  
  1614.  
  1615.  
  1616.  
  1617.  
  1618.  
  1619.  
  1620.  
  1621.  
  1622.  
  1623.  
  1624.  
  1625.  
  1626.  
  1627.  
  1628.  
  1629.  
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.           ___________________________________________________________________
  1644.           Copyright 1992, JP Software Inc.       4OS2 Reference Manual  /  25
  1645.  
  1646.                                          CHAPTER 4 / CONFIGURATION AND TUNING
  1647.           ___________________________________________________________________
  1648.  
  1649.  
  1650.  
  1651.           CHAPTER 4 / CONFIGURATION AND TUNING
  1652.  
  1653.                  [see page 107 in the 4DOS Reference Manual]
  1654.  
  1655.           4OS2 can be configured in three different ways: with command-line
  1656.           options, through its initialization file, and via the SETDOS
  1657.           command.  The SETDOS command is described on page 45 of this manual
  1658.           and page 280 of the 4DOS Reference Manual.  Command line options
  1659.           and the initialization file are described in this chapter.  This
  1660.           chapter also discusses how to configure the 4OS2 help system and
  1661.           how to use 4DOS effectively in DOS sessions.
  1662.  
  1663.           Creating and Configuring 4OS2 Icons
  1664.  
  1665.                You can create as many 4OS2 icons as you wish on the OS/2
  1666.                desktop.  Different icons can be used to start 4OS2 in
  1667.                different modes, with different startup commands or options,
  1668.                or to run different batch files or other commands.  You can
  1669.                use these icons to run commonly-used commands and batch files
  1670.                directly from the OS/2 desktop.
  1671.  
  1672.                Each icon represents a different 4OS2 session and you can set
  1673.                up any of these sessions to run in windowed or full-screen
  1674.                mode.  You can also set any necessary command line parameters
  1675.                for 4OS2 such as a command to be executed, any desired
  1676.                switches, and the name and path for 4OS2.INI.  More
  1677.                information on command line switches and options for 4OS2, and
  1678.                on 4OS2.INI, is included later in this section.
  1679.  
  1680.                For general information on creating and configuring icons, see
  1681.                page 12.  For additional details, see your OS/2 documentation.
  1682.  
  1683.                When you configure a 4OS2 icon, place command line parameters
  1684.                that you want passed to 4OS2 (e.g. @ininame) into the
  1685.                Parameters field for the icon.
  1686.  
  1687.                To run a startup batch file for a particular 4OS2 session,
  1688.                include its name (with a path, if the batch file is not in the
  1689.                session's startup directory) as the last item in the
  1690.                Parameters field.  That batch file will be executed after any
  1691.                4START file but before the first prompt is displayed.  You can
  1692.                use the batch file to set environment variables and execute
  1693.                any other 4OS2 commands.  You can also execute any internal
  1694.                4OS2 command, external command, or alias by placing its name
  1695.                in the Parameters field.  When you set up a batch file or
  1696.                other command to run in this way you are using the command
  1697.                command line option (see below).
  1698.  
  1699.  
  1700.           ___________________________________________________________________
  1701.           Copyright 1992, JP Software Inc.       4OS2 Reference Manual  /  26
  1702.  
  1703.                                          CHAPTER 4 / CONFIGURATION AND TUNING
  1704.           ___________________________________________________________________
  1705.  
  1706.  
  1707.  
  1708.                To execute an internal or external command, an alias, or a
  1709.                batch file and then exit (return to the desktop) when it is
  1710.                done, place /C command (rather than just command) as the last
  1711.                item in the Parameters field.
  1712.  
  1713.                If 4OS2 is installed in your CONFIG.SYS file and for some
  1714.                reason you wish to run the default OS/2 shell, CMD.EXE, you
  1715.                can set up an icon for it by creating a new icon and
  1716.                specifying the full path name of CMD.EXE rather than [*] as
  1717.                the file to run.
  1718.  
  1719.  
  1720.           4OS2 Command Line Options
  1721.  
  1722.                The 4OS2 command line does not need to contain any
  1723.                information.  When invoked with an empty command line, 4OS2
  1724.                will configure itself from the 4OS2.INI file, run 4START, and
  1725.                then display a prompt and wait for you to type a command.
  1726.                However, you may add information to the 4OS2 command line that
  1727.                will affect the way it operates.
  1728.  
  1729.                Command line options for primary shells are set in the
  1730.                Parameters field of the 4OS2 icon.  If you need help finding
  1731.                and setting the Parameters field for your version of OS/2, see
  1732.                page 12.  Command line options for secondary shells can be set
  1733.                using 4OS2.INI file directives, or typed on the command line
  1734.                itself following the program name if the shell is started from
  1735.                a prompt.
  1736.  
  1737.                4OS2 recognizes 5 optional fields on the command line.  If you
  1738.                use more than one of these fields, their order is important.
  1739.                The syntax for the commands is
  1740.  
  1741.                     [d:\path] [@d:\path\inifile] [/S] [//iniline]... [/C |
  1742.                     /K] [command]
  1743.  
  1744.                In this syntax statement, items in square brackets are
  1745.                optional.  The //iniline option may be repeated.
  1746.  
  1747.                In the descriptions below of each of these optional fields, d:
  1748.                means a drive letter and \path means a subdirectory name.
  1749.  
  1750.                d:\path     4OS2 will use this directory and path to set the
  1751.                            COMSPEC environment variable for this session.
  1752.                            If this option is not used, COMSPEC is set from
  1753.                            the location of 4OS2.EXE.  Since 4OS2 always
  1754.                            knows what drive and directory it was started
  1755.                            from, there is little reason to use this option.
  1756.  
  1757.           ___________________________________________________________________
  1758.           Copyright 1992, JP Software Inc.       4OS2 Reference Manual  /  27
  1759.  
  1760.                                          CHAPTER 4 / CONFIGURATION AND TUNING
  1761.           ___________________________________________________________________
  1762.  
  1763.  
  1764.                            It is included only for compatibility with OS/2's
  1765.                            default shell program, CMD.EXE.  This option
  1766.                            cannot be used for secondary shells.
  1767.  
  1768.                @d:\path\inifile
  1769.                            This option sets the path and name of the
  1770.                            4OS2.INI file, which is discussed below.  You do
  1771.                            not need this option if you aren't using a
  1772.                            4OS2.INI file.  Nor do you need this option if
  1773.                            the file is named 4OS2.INI and it is in the same
  1774.                            subdirectory as 4OS2.EXE or in the root directory
  1775.                            of the same drive.  Otherwise, this option must
  1776.                            be included.  This option is most useful if you
  1777.                            want to start a 4OS2 session with a specific and
  1778.                            unique INI file.
  1779.  
  1780.                /S          This option tells 4OS2 that you do not want it to
  1781.                            set up a Ctrl-C / Ctrl-Break handler.  It is
  1782.                            included for compatibility with CMD.EXE, but it
  1783.                            may cause the system to operate incorrectly if
  1784.                            you use this option without other software to
  1785.                            handle Ctrl-C and Ctrl-Break.  This option should
  1786.                            be avoided by most users.  This option cannot be
  1787.                            used for secondary shells.
  1788.  
  1789.                //iniline   This option tells 4OS2 to treat the text
  1790.                            appearing between the // and the next space or
  1791.                            tab as a 4OS2.INI directive (see below for a
  1792.                            discussion of 4OS2.INI).  The directive should be
  1793.                            in the same format as a line in 4OS2.INI, but it
  1794.                            may not contain spaces, tabs, or comments.  This
  1795.                            option overrides any corresponding directive in
  1796.                            your 4OS2.INI file.  This option is a convenient
  1797.                            way to send 4OS2 one or two simple directives
  1798.                            without modifying or creating a new 4OS2.INI
  1799.                            file.
  1800.  
  1801.                [/C | /K] command
  1802.                            This option tells 4OS2 to run a command when it
  1803.                            starts.  The command will be run after 4START has
  1804.                            been executed, and before any command prompt is
  1805.                            displayed.  It can be any valid internal or
  1806.                            external command, batch file, or alias command,
  1807.                            and you may include multiple commands by using
  1808.                            the command separator.  All other startup options
  1809.                            (such as //iniline) must be placed before the
  1810.                            command, because 4OS2 will treat characters after
  1811.                            the command as part of the command and not as
  1812.                            additional startup options.
  1813.  
  1814.           ___________________________________________________________________
  1815.           Copyright 1992, JP Software Inc.       4OS2 Reference Manual  /  28
  1816.  
  1817.                                          CHAPTER 4 / CONFIGURATION AND TUNING
  1818.           ___________________________________________________________________
  1819.  
  1820.  
  1821.  
  1822.                            When the command is preceded by a /C, 4OS2 will
  1823.                            execute the command and then exit and close the
  1824.                            session and return to the parent program, without
  1825.                            displaying a prompt.
  1826.  
  1827.                            The /K switch has no effect; using it is the same
  1828.                            as placing the command (without a /C or /K) at
  1829.                            the end of the startup command line.  It is
  1830.                            included only for compatibility with CMD.EXE.
  1831.  
  1832.  
  1833.           Using 4OS2.INI
  1834.  
  1835.                4OS2 uses a file of initialization information called the
  1836.                4OS2.INI file.  You can add to and edit this file with any
  1837.                ASCII text editor to set 4OS2 options and alter the way that
  1838.                4OS2 works.  Most of this section explains the options
  1839.                available through 4OS2.INI.  You only need to include entries
  1840.                in 4OS2.INI for any settings that you want to change from
  1841.                their default values.  If you are happy with all of the
  1842.                default values, you don't need a 4OS2.INI file at all.
  1843.  
  1844.                Some settings in 4OS2.INI are initialized when you install
  1845.                4OS2, so you may have a 4OS2.INI file even if you didn't
  1846.                create one yourself.  You should not delete this file unless
  1847.                you've checked carefully to be sure that you don't need any of
  1848.                the settings the initialization program put there.
  1849.  
  1850.                In general, the 4OS2.INI file works the same as the 4DOS.INI
  1851.                file described on page 116 of the 4DOS Reference Manual.  The
  1852.                following paragraphs only describe the differences between the
  1853.                two files and the way they are processed.
  1854.  
  1855.                4OS2.INI Directives
  1856.  
  1857.                     The following directives are used only in 4OS2:
  1858.  
  1859.                     HelpBook = string (4OS2+CMDREF):  Sets the names of the
  1860.                     "books" to be loaded when 4OS2 help is invoked with the
  1861.                     HELP command or the F1 key.  The default is 4OS2+CMDREF
  1862.                     which loads the 4OS2 help and the OS/2 command reference.
  1863.                     See the next section for details about the use of this
  1864.                     directive.
  1865.  
  1866.                     LocalLists = Yes | NO:  Normally, 4OS2 shares alias and
  1867.                     history lists among all running shells.  Set to "yes" to
  1868.                     force use of local alias and history lists instead of
  1869.                     shared global lists.
  1870.  
  1871.           ___________________________________________________________________
  1872.           Copyright 1992, JP Software Inc.       4OS2 Reference Manual  /  29
  1873.  
  1874.                                          CHAPTER 4 / CONFIGURATION AND TUNING
  1875.           ___________________________________________________________________
  1876.  
  1877.  
  1878.  
  1879.                     WindowCol = nnnn;  WindowHeight = nnnn;  WindowRow =
  1880.                     nnnn;  WindowWidth = nnnn:  These directives set the
  1881.                     initial position and size of the 4OS2 session window in
  1882.                     pels.  The position 0,0 is the bottom left corner of the
  1883.                     screen.  WindowCol and WindowRow set the bottom left
  1884.                     corner of the 4OS2 window;  WindowHeight and WindowWidth
  1885.                     set its size.  Set WindowWidth to 2048 to maximize the
  1886.                     window, in which case the other values will be ignored.
  1887.                     The default is to leave the window wherever OS/2 puts it.
  1888.  
  1889.                The following 4DOS.INI directives may not be used in a
  1890.                4OS2.INI file.  These directives are specific to DOS features
  1891.                or limitations which do not exist in OS/2:
  1892.  
  1893.                     Alias                      LineInput
  1894.                     ANSI                       MessageServer
  1895.                     AutoExecPath               NetwareNames
  1896.                     DiskReset                  Reduce
  1897.                     DVCleanup                  ReserveTPA
  1898.                     EnvFree                    StackSize
  1899.                     Environment                Swapping
  1900.                     FineSwap                   SwapReopen
  1901.                     FullINT2E                  UMBEnvironment
  1902.                     HelpOptions                UMBLoad
  1903.                     HelpPath                   UniqueSwapName
  1904.  
  1905.           Configuring 4OS2 Help
  1906.  
  1907.                In order for the 4OS2 help system to work properly, both
  1908.                VIEW.EXE and the help text file, 4OS2.INF, must be in their
  1909.                proper locations.  VIEW.EXE is normally stored in the \OS2
  1910.                directory.  This directory must be included in your PATH (as
  1911.                it normally is) so that 4OS2 can find and start VIEW.
  1912.  
  1913.                During automated installation, 4OS2.INF is copied to your 4OS2
  1914.                installation directory.  VIEW must be able to find this file
  1915.                or you will receive a "file not found" message box and no help
  1916.                will be displayed.  VIEW looks for help files in the
  1917.                directories defined by the BOOKSHELF environment variable in
  1918.                CONFIG.SYS.  (BOOKSHELF, like PATH, contains a list of
  1919.                directory names, separated by semicolons.)
  1920.  
  1921.                You can make the 4OS2 help text available to VIEW by either
  1922.                moving 4OS2.INF to the standard "book" directory shown on the
  1923.                SET BOOKSHELF line in CONFIG.SYS (normally \OS2\BOOK), or by
  1924.                adding the 4OS2 directory to the BOOKSHELF setting.  The
  1925.                latter method is the one used by 4OS2's automated installation
  1926.                program.
  1927.  
  1928.           ___________________________________________________________________
  1929.           Copyright 1992, JP Software Inc.       4OS2 Reference Manual  /  30
  1930.  
  1931.                                          CHAPTER 4 / CONFIGURATION AND TUNING
  1932.           ___________________________________________________________________
  1933.  
  1934.  
  1935.  
  1936.                OS/2 includes a complete reference to all internal and
  1937.                external commands in the reference book named CMDREF.  This
  1938.                book is stored in the file \OS2\BOOK\CMDREF.INF.  In addition,
  1939.                we include with 4OS2 a complete help reference for 4DOS, so
  1940.                that you can develop and edit 4DOS batch files and aliases
  1941.                while working under OS/2.  The book name for this text is 4DOS
  1942.                and the file name is 4DOS.INF.  In order to use these files,
  1943.                they must also be accessible to VIEW through the BOOKSHELF
  1944.                variable.
  1945.  
  1946.                4OS2 normally passes the help file name "4OS2+CMDREF" to VIEW,
  1947.                which then opens the 4OS2 help text and the OS/2 command
  1948.                reference.  However, you can specify a different set of
  1949.                "books" to be opened when HELP or F1 is invoked.  To do so,
  1950.                use the HelpBook directive in 4OS2.INI (see page 29).
  1951.  
  1952.                For example, to set up 4OS2 so that all three books are
  1953.                displayed when F1 is pressed, you would include the following
  1954.                directive in 4OS2.INI:
  1955.  
  1956.                     HelpBook=4OS2+4DOS+CMDREF
  1957.  
  1958.                When more than one book is listed in the HelpBook setting,
  1959.                VIEW will see the combined group as a single book.  The Table
  1960.                of Contents displayed by VIEW will include the tables of
  1961.                contents from all the listed books, concatenated together as
  1962.                one group of topics with no divisions to show where one book
  1963.                ends and the next begins.
  1964.  
  1965.                If you wish, you can set up a separate icon for 4OS2 help
  1966.                which can be invoked from your desktop.  To do so, create an
  1967.                icon with VIEW.EXE as the program name and 4OS2 in the
  1968.                parameter field.  To include other books in the table of
  1969.                contents displayed when this session is started, use the plus
  1970.                sign [+].  For example to make the icon show both 4OS2 and
  1971.                4DOS help place 4OS2+4DOS in the parameters field.
  1972.  
  1973.  
  1974.           Using 4DOS with OS/2
  1975.  
  1976.                The combination of 4OS2 and 4DOS gives you a consistent user
  1977.                interface whether you boot your computer with DOS or OS/2, and
  1978.                whether you are in OS/2 character mode or running an OS/2 DOS
  1979.                session.  However, to use DOS, 4DOS, and OS/2 successfully
  1980.                requires some planning if you want to get all of the power
  1981.                possible out of each operating environment.
  1982.  
  1983.  
  1984.  
  1985.           ___________________________________________________________________
  1986.           Copyright 1992, JP Software Inc.       4OS2 Reference Manual  /  31
  1987.  
  1988.                                          CHAPTER 4 / CONFIGURATION AND TUNING
  1989.           ___________________________________________________________________
  1990.  
  1991.  
  1992.  
  1993.                This section explains some of the planning you should do and
  1994.                some of the techniques you can use to get everything working
  1995.                together correctly.  Throughout this chapter, we assume that
  1996.                you want to use 4DOS as your command processor when you boot
  1997.                in native DOS mode and when you run a DOS session in OS/2, and
  1998.                that you are using 4OS2 as your command processor in OS/2
  1999.                character mode.  Also, we assume that you have installed 4DOS
  2000.                in the C:\4DOS\ directory and that 4DOS.INI plus your 4START
  2001.                and 4EXIT files, if you have them, are also in that directory.
  2002.  
  2003.  
  2004.                Startup Files
  2005.  
  2006.                Before discussing the wide range of options you have for
  2007.                configuring 4DOS and 4OS2 to work together, we thought it
  2008.                would be useful to review the different startup files used
  2009.                under DOS and OS/2, and the purpose of each.  In the text
  2010.                below, "boot drive" refers to the drive from which the
  2011.                operating system boots.  In most cases this will be drive C:
  2012.                or drive A:, but if you are using OS/2 version 2.0's Boot
  2013.                Manager (see below), you may boot OS/2 from another drive.
  2014.  
  2015.                CONFIG.SYS       Contains commands to configure the operating
  2016.                                 system, load device drivers, and determine
  2017.                                 the command processor to be used.  Under
  2018.                                 OS/2, commands in CONFIG.SYS provide this
  2019.                                 information for both OS/2 itself and for DOS
  2020.                                 sessions which run under OS/2.  CONFIG.SYS
  2021.                                 is stored in the root directory of the boot
  2022.                                 drive.
  2023.  
  2024.                AUTOEXEC.BAT     Contains commands to be executed by the DOS
  2025.                                 command processor (COMMAND.COM or 4DOS) when
  2026.                                 a primary shell starts.  AUTOEXEC.BAT is
  2027.                                 stored in the root directory of the boot
  2028.                                 drive.  Under 4DOS, you can store it in a
  2029.                                 different directory if you use the
  2030.                                 AutoExecPath directive in 4DOS.INI.
  2031.  
  2032.                4START           Contains commands to be executed by 4DOS or
  2033.                                 4OS2 when a primary or secondary shell
  2034.                                 starts.  A file named 4START.BTM will be
  2035.                                 executed by both 4DOS and 4OS2; a file named
  2036.                                 4START.BAT will be executed by 4DOS only;
  2037.                                 and a file named 4START.CMD will be executed
  2038.                                 by 4OS2 only.  4DOS and 4OS2 first look for
  2039.                                 4START in the directory specified in the
  2040.                                 4StartPath directive in 4DOS.INI or
  2041.  
  2042.           ___________________________________________________________________
  2043.           Copyright 1992, JP Software Inc.       4OS2 Reference Manual  /  32
  2044.  
  2045.                                          CHAPTER 4 / CONFIGURATION AND TUNING
  2046.           ___________________________________________________________________
  2047.  
  2048.  
  2049.                                 4OS2.INI.  If 4StartPath is not used, they
  2050.                                 then look in the directory where 4DOS or
  2051.                                 4OS2 themselves are stored, and finally in
  2052.                                 the root directory of the boot drive.
  2053.  
  2054.                4EXIT            Contains commands to be executed by 4DOS or
  2055.                                 4OS2 when a primary or secondary shell
  2056.                                 exits.  For details, see 4START above.
  2057.  
  2058.                STARTUP.CMD      Contains commands to be executed by a
  2059.                                 special 4OS2 or CMD.EXE session which is
  2060.                                 automatically started by OS/2 when it boots
  2061.                                 if it finds STARTUP.CMD in the root
  2062.                                 directory of the boot drive.
  2063.  
  2064.                4DOS.INI         Contains configuration commands for 4DOS
  2065.                                 primary and secondary shells.  4DOS normally
  2066.                                 searches for 4DOS.INI in the directory where
  2067.                                 4DOS.COM is stored, then in the root
  2068.                                 directory of the drive where 4DOS.COM is
  2069.                                 stored, then in the root directory of the
  2070.                                 boot drive.  You can specify a different
  2071.                                 location using the @ininame option on the
  2072.                                 4DOS command line.
  2073.  
  2074.                4OS2.INI         Contains configuration commands for 4OS2
  2075.                                 primary and secondary shells.  4OS2 normally
  2076.                                 searches for 4OS2.INI in the directory where
  2077.                                 4OS2.EXE is stored, then in the root
  2078.                                 directory of the drive where 4OS2.EXE is
  2079.                                 stored.  You can specify a different
  2080.                                 location using the @ininame option on the
  2081.                                 4OS2 command line.
  2082.  
  2083.  
  2084.                Methods of Booting
  2085.  
  2086.                OS/2 includes two different methods of switching between
  2087.                native DOS mode (a standard DOS boot, not an OS/2 "Native DOS
  2088.                Session") and OS/2 itself.  The first is to use the dual boot
  2089.                software included with OS/2, which switches around CONFIG.SYS
  2090.                and AUTOEXEC.BAT, and then reboots the computer.  Dual boot is
  2091.                invoked with the BOOT command (the program BOOT.COM)
  2092.                distributed with OS/2.  If you use the dual boot software, you
  2093.                will have one copy of CONFIG.SYS and AUTOEXEC.BAT available on
  2094.                your boot drive when you boot in DOS mode and another version
  2095.                available when you boot in OS/2 mode.
  2096.  
  2097.  
  2098.  
  2099.           ___________________________________________________________________
  2100.           Copyright 1992, JP Software Inc.       4OS2 Reference Manual  /  33
  2101.  
  2102.                                          CHAPTER 4 / CONFIGURATION AND TUNING
  2103.           ___________________________________________________________________
  2104.  
  2105.  
  2106.  
  2107.                The Boot Manager (included with OS/2 version 2.0 only) uses a
  2108.                different approach.  It lets you install DOS on one hard drive
  2109.                partition and OS/2 on another partition.  When you boot the
  2110.                computer, the Boot Manager displays a menu and lets you pick
  2111.                which operating system to boot.  Each partition will have its
  2112.                own versions of CONFIG.SYS and AUTOEXEC.BAT.
  2113.  
  2114.                The difference between these approaches is the location and
  2115.                availability of files.  If you use dual boot, all booting is
  2116.                from the same drive.  The startup files get switched back and
  2117.                forth as you boot from one operating system or the other; the
  2118.                set of files not in use at any given time is stored in the
  2119.                \OS2\SYSTEM directory, and the set that is in use is stored in
  2120.                the root directory of the boot drive.  If you use the Boot
  2121.                Manager, all startup files are available simultaneously.
  2122.                However, the set of files for DOS resides on one drive (for
  2123.                example, C) and the OS/2 set is on another drive (for example,
  2124.                D).
  2125.  
  2126.                In both cases, you are responsible for keeping files
  2127.                synchronized.  For example, if your DOS-mode AUTOEXEC.BAT file
  2128.                and your OS/2 mode AUTOEXEC.BAT do essentially the same thing,
  2129.                and if you want to add a new command, you have to remember to
  2130.                update both files.  One way to avoid doing so is to create a
  2131.                new bootup batch file and make sure that both versions of
  2132.                AUTOEXEC.BAT call it.  Then you only have to maintain one file
  2133.                of general boot information.
  2134.  
  2135.                If you are using OS/2 version 2.0, there is one additional and
  2136.                very important wrinkle.  You can run multiple DOS sessions
  2137.                (VDMs).  Each time you start a new VDM, it will execute your
  2138.                AUTOEXEC.BAT file, whether you want it to or not.  We'll
  2139.                explain below how to avoid running all of your AUTOEXEC.BAT
  2140.                file in every VDM.
  2141.  
  2142.  
  2143.                Setting Up OS/2 and 4DOS
  2144.  
  2145.                First make sure that you have 4DOS set up to run properly from
  2146.                a pure DOS boot.  Use the 4DOS Reference Manual and the 4DOS
  2147.                installation program to set your DOS-based CONFIG.SYS and
  2148.                AUTOEXEC.BAT files the way you want them.  Then boot in OS/2
  2149.                mode or make sure that the OS/2 versions of these files are
  2150.                available.  The remainder of this section focuses on the OS/2
  2151.                versions of CONFIG.SYS and AUTOEXEC.BAT, not the DOS versions.
  2152.  
  2153.                Before you make any changes to CONFIG.SYS, AUTOEXEC.BAT, or
  2154.                other bootup files, make sure that you have a bootable floppy
  2155.  
  2156.           ___________________________________________________________________
  2157.           Copyright 1992, JP Software Inc.       4OS2 Reference Manual  /  34
  2158.  
  2159.                                          CHAPTER 4 / CONFIGURATION AND TUNING
  2160.           ___________________________________________________________________
  2161.  
  2162.  
  2163.                disk so that an error won't leave your system unbootable..
  2164.                You're not likely to create such an error, especially under
  2165.                OS/2, but this is always a wise precaution.
  2166.  
  2167.                Now change the SHELL= line in your CONFIG.SYS file to read
  2168.  
  2169.                          SHELL=c:\4dos\4dos.com  c:\4dos
  2170.  
  2171.                The first part of that statement simply sets 4DOS.COM as your
  2172.                shell program for DOS sessions.  The second part specifies the
  2173.                COMSPEC setting that will be used each time 4DOS is started as
  2174.                a primary shell.  The COMSPEC setting is required unless
  2175.                4DOS.COM is stored in the root directory of your boot drive.
  2176.                4DOS is generally able to determine the COMSPEC setting
  2177.                automatically in a standard boot under MS-DOS or PC-DOS, but
  2178.                it cannot do so in an OS/2 DOS session.  You may want to add
  2179.                other 4DOS options to the command line, as well;  see page 108
  2180.                in the 4DOS Reference Manual.
  2181.  
  2182.                If you are using OS/2 version 1.x, the SHELL command in your
  2183.                CONFIG.SYS file will determine how 4DOS boots up when you
  2184.                invoke the DOS Compatibility Box from the OS/2 desktop.
  2185.  
  2186.                If you are using OS/2 version 2.0, you can have multiple icons
  2187.                for Virtual DOS Machines (VDMs).  These may include icons in
  2188.                the Command Prompts window, icons for "migrated applications,"
  2189.                icons for DOS and Windows applications, and icons for batch
  2190.                files.  Each VDM icon contains its own information about how
  2191.                to boot DOS.  In essence, each VDM icon has its own CONFIG.SYS
  2192.                file built into it.
  2193.  
  2194.                To modify an icon's configuration information, use the DOS
  2195.                Settings button on the Session tab in the Settings window (see
  2196.                page 12 for more details on modifying the settings for an
  2197.                icon).  The setting labeled DOS_SHELL determines what command
  2198.                processor to load when the icon is used to start a session;
  2199.                it should be set to match the text following SHELL= in
  2200.                CONFIG.SYS.  For example, you might set the DOS_SHELL setting
  2201.                to:
  2202.  
  2203.                     c:\4dos\4dos.com c:\4dos
  2204.  
  2205.                Other settings modify other session characteristics, such as
  2206.                available XMS and EMS memory, device drivers to load, and so
  2207.                on.
  2208.  
  2209.                If you create an icon by using a Program Template, the DOS
  2210.                Settings information is read from the current CONFIG.SYS file.
  2211.  
  2212.  
  2213.           ___________________________________________________________________
  2214.           Copyright 1992, JP Software Inc.       4OS2 Reference Manual  /  35
  2215.  
  2216.                                          CHAPTER 4 / CONFIGURATION AND TUNING
  2217.           ___________________________________________________________________
  2218.  
  2219.  
  2220.                If you create a VDM icon by copying an existing icon, the
  2221.                original icon's information will be used in the new icon.
  2222.  
  2223.                Once you have the DOS settings correct, place a "*" in the
  2224.                Program Name field (available on the Program tab in the
  2225.                Settings window).  This tells OS/2 to load the command
  2226.                processor and go to a prompt, rather than running a specific
  2227.                program within the session.
  2228.  
  2229.                You may, of course, customize any icon with optional 4DOS
  2230.                command line switches, such as "@" followed by a custom INI
  2231.                file name, or "//" followed by an INI file command.  These
  2232.                switches can be placed at the end of the DOS_SHELL setting, or
  2233.                in the Parameters field in the Program window.
  2234.  
  2235.                When you first install OS/2 version 2.0, or if you change the
  2236.                4DOS settings in CONFIG.SYS, you will need to correct the
  2237.                DOS_SHELL setting in your existing VDM icons.  Change
  2238.                DOS_SHELL to match the text that follows SHELL= in your
  2239.                CONFIG.SYS file.
  2240.  
  2241.  
  2242.                Other 4DOS Considerations
  2243.  
  2244.                Regardless of whether you use a dual boot system, the Boot
  2245.                Manager, or boot only in OS/2, each DOS session starts 4DOS
  2246.                (or COMMAND.COM) as a primary shell.  4DOS will execute your
  2247.                AUTOEXEC.BAT file plus 4START.  If the session starts as a VDM
  2248.                under OS/2 version 2.0, it can be closed with the EXIT
  2249.                command.  When it is, 4DOS will run your 4EXIT file, if you
  2250.                have one.  This is different from DOS, where EXIT cannot be
  2251.                used in a primary shell.
  2252.  
  2253.                You may want to maintain separate AUTOEXEC.BAT files for
  2254.                booting under DOS and under OS/2, or you may want a single
  2255.                file that contains instructions for both boot modes.  One way
  2256.                to put instructions for both boot modes into a single file is
  2257.                to use the IFF command and the %_DOSVER internal variable (see
  2258.                page 22 for a detailed example).
  2259.  
  2260.                If you are using the Boot Manager, you can put all of your
  2261.                instructions in the DOS-mode AUTOEXEC.BAT file.  Then your
  2262.                OS/2-mode AUTOEXEC.BAT could simply be
  2263.  
  2264.                     cdd c:\
  2265.                     autoexec.bat
  2266.  
  2267.                On a dual boot system, you could put all of your commands into
  2268.                a third file (for example, SYSTART.BAT) and CALL it from both
  2269.  
  2270.           ___________________________________________________________________
  2271.           Copyright 1992, JP Software Inc.       4OS2 Reference Manual  /  36
  2272.  
  2273.                                          CHAPTER 4 / CONFIGURATION AND TUNING
  2274.           ___________________________________________________________________
  2275.  
  2276.  
  2277.                your DOS-mode and OS/2-mode AUTOEXEC.BAT files.  Or, you could
  2278.                simply put your AUTOEXEC.BAT somewhere other than your root
  2279.                directory and use the 4DOS.INI directive AutoExecPath to tell
  2280.                4DOS where to find it.
  2281.  
  2282.                You may also need to customize your 4START and 4EXIT files, if
  2283.                you use them, for DOS mode and OS/2 mode.  You can use the
  2284.                internal variable %_DOS to separate commands for each
  2285.                operating system.  You will also have to make sure that 4DOS
  2286.                can find its 4DOS.INI file along with 4START and 4EXIT.
  2287.                Probably the best method is to put those files in the same
  2288.                directory as 4DOS.COM and then make sure that COMSPEC is set
  2289.                for that directory as described above.
  2290.  
  2291.                If you use dual boot and want different 4DOS.INI files for DOS
  2292.                mode and OS/2 mode, remember that the dual boot program does
  2293.                not swap the 4DOS.INI files for you.  Therefore, one of your
  2294.                CONFIG.SYS files must invoke a different file using the
  2295.                "@ininame" option on the SHELL= line.
  2296.  
  2297.                If you run 4DOS in two or more Virtual DOS Machines that use
  2298.                disk swapping, you can crash the system because each 4DOS
  2299.                primary shell will use the same 4DOSSWAP.000 file.  You can
  2300.                avoid this problem if you make sure that each VDM has enough
  2301.                XMS or EMS memory (use the EMS_MEMORY or XMS_MEMORY setting in
  2302.                DOS Settings) and if both VDMs use 4DOS's default swapping.
  2303.                You can also avoid the problem by varying the swap location
  2304.                for each VDM's copy of 4DOS with a separate 4DOS.INI file or
  2305.                with a "//swapping=" directive in the DOS_SHELL setting.  A
  2306.                future version of 4DOS will include a new 4DOS.INI directive,
  2307.                UniqueSwapName, which will allow you to change to a different
  2308.                naming convention for swap files to avoid this problem.
  2309.  
  2310.  
  2311.                "Temporary" VDMs
  2312.  
  2313.                So far, we have assumed that you want to start a VDM to run
  2314.                4DOS and get to the DOS prompt.  OS/2 version 2.0 also lets
  2315.                you start a VDM for temporary purposes, such as running a DOS
  2316.                application or a batch file from an icon.  In such a temporary
  2317.                VDM, 4DOS is still loaded as a primary shell even though it is
  2318.                being invoked to run just a single command or application.  It
  2319.                is also loaded as a "transient" shell which exits (back to
  2320.                OS/2) when its job is done.  You probably don't want a
  2321.                temporary VDM to load all the memory-resident utilities and
  2322.                execute the other commands that you want when you are setting
  2323.                up a DOS prompt.  Most users would rather set up as simple a
  2324.                VDM as possible, run the command, and exit as quickly as
  2325.                possible.
  2326.  
  2327.           ___________________________________________________________________
  2328.           Copyright 1992, JP Software Inc.       4OS2 Reference Manual  /  37
  2329.  
  2330.                                          CHAPTER 4 / CONFIGURATION AND TUNING
  2331.           ___________________________________________________________________
  2332.  
  2333.  
  2334.  
  2335.                The 4DOS internal variable %_TRANSIENT makes it easy to adjust
  2336.                your AUTOEXEC.BAT to the job required.  The beginning of your
  2337.                AUTOEXEC.BAT file could look like this:
  2338.  
  2339.                     iff %_transient == 1 then
  2340.                          call setpath
  2341.                          call aliases
  2342.                          call setenv
  2343.                          quit
  2344.                     endiff
  2345.  
  2346.                This fragment calls other batch files to set up the path,
  2347.                aliases, and the environment, but it does not load TSRs.  It
  2348.                doesn't have to check the DOS version to see if it is running
  2349.                under OS/2 because _TRANSIENT will never equal 1 in
  2350.                AUTOEXEC.BAT unless it is being launched within a VDM.
  2351.  
  2352.  
  2353.  
  2354.  
  2355.  
  2356.  
  2357.  
  2358.  
  2359.  
  2360.  
  2361.  
  2362.  
  2363.  
  2364.  
  2365.  
  2366.  
  2367.  
  2368.  
  2369.  
  2370.  
  2371.  
  2372.  
  2373.  
  2374.  
  2375.  
  2376.  
  2377.  
  2378.  
  2379.  
  2380.  
  2381.  
  2382.  
  2383.  
  2384.           ___________________________________________________________________
  2385.           Copyright 1992, JP Software Inc.       4OS2 Reference Manual  /  38
  2386.  
  2387.                                           CHAPTER 5 / COMMAND REFERENCE GUIDE
  2388.           ___________________________________________________________________
  2389.  
  2390.  
  2391.  
  2392.           CHAPTER 5 / COMMAND REFERENCE GUIDE
  2393.  
  2394.                  [see page 157 in the 4DOS Reference Manual]
  2395.  
  2396.                The following commands are unique to 4OS2:
  2397.  
  2398.                DETACH  (start an OS/2 program in detached mode)
  2399.  
  2400.                DPATH  (set the search path for data files)
  2401.  
  2402.                KEYS  (alternate command to enable or display the history
  2403.                list)
  2404.  
  2405.                START  (start a program in a new session)
  2406.  
  2407.                All of these commands are described in detail on the following
  2408.                pages.
  2409.  
  2410.                In addition, DIR and SETDOS have different options available
  2411.                in 4OS2 than they do in 4DOS.  The new options available for
  2412.                DIR support displays in either the high performance file
  2413.                system (HPFS) or tradition DOS-compatible FAT format.  SETDOS
  2414.                in OS/2 does not have the ANSI and Line Input options that are
  2415.                available in 4DOS.  These changes are also described in detail
  2416.                on the following pages.
  2417.  
  2418.                The following 4DOS commands are not available in 4OS2:
  2419.  
  2420.                     BREAK                      LOADHIGH / LH
  2421.  
  2422.                     CTTY                       SWAPPING
  2423.  
  2424.                     KEYSTACK                   TRUENAME
  2425.  
  2426.                Finally, the /M(aster environment) option is not available in
  2427.                the 4OS2 versions of ESET, SET, and UNSET.
  2428.  
  2429.  
  2430.  
  2431.  
  2432.  
  2433.  
  2434.  
  2435.  
  2436.  
  2437.  
  2438.  
  2439.  
  2440.  
  2441.           ___________________________________________________________________
  2442.           Copyright 1992, JP Software Inc.       4OS2 Reference Manual  /  39
  2443.  
  2444.                                CHAPTER 5 / COMMAND REFERENCE GUIDE  /  DETACH
  2445.           ___________________________________________________________________
  2446.  
  2447.  
  2448.           DETACH
  2449.                                                                  (Compatible)
  2450.  
  2451.           Purpose:    Start an OS/2 program in detached mode.
  2452.  
  2453.           Format:     DETACH filename
  2454.  
  2455.                       filename: the name of a file, including an optional
  2456.                       drive and path specification.  The name may be
  2457.                       enclosed in quotation marks if it contains a space.
  2458.  
  2459.                       See also: START
  2460.  
  2461.           Usage:      When you start a program with DETACH, that program
  2462.                       cannot use the keyboard, mouse, or video display.  It
  2463.                       is "detached" from the normal means of user input and
  2464.                       output.  However, you can redirect the program's
  2465.                       standard I/O to other devices if necessary, using the
  2466.                       4OS2 redirection symbols.
  2467.  
  2468.                       If you specify an internal command or batch file
  2469.                       (either a .CMD or .BTM file) as the filename, 4OS2
  2470.                       will detach another copy of 4OS2.EXE to execute the
  2471.                       command.
  2472.  
  2473.                       For example, the following command will detach a copy
  2474.                       of 4OS2 to run the batch file XYZ.BTM:
  2475.  
  2476.                            [c:\]detach xyz.btm
  2477.  
  2478.                       Once the program has started 4OS2 returns to the
  2479.                       prompt immediately.  It does not wait for a detached
  2480.                       program to finish.
  2481.  
  2482.  
  2483.  
  2484.  
  2485.  
  2486.  
  2487.  
  2488.  
  2489.  
  2490.  
  2491.  
  2492.  
  2493.  
  2494.  
  2495.  
  2496.  
  2497.  
  2498.           ___________________________________________________________________
  2499.           Copyright 1992, JP Software Inc.       4OS2 Reference Manual  /  40
  2500.  
  2501.                                   CHAPTER 5 / COMMAND REFERENCE GUIDE  /  DIR
  2502.           ___________________________________________________________________
  2503.  
  2504.  
  2505.           DIR
  2506.                                                                    (Enhanced)
  2507.                  [see page 198 of the 4DOS Reference Manual]
  2508.  
  2509.           Purpose:    Display information about files and subdirectories.
  2510.  
  2511.           Format:     DIR [/1 /2 /4 /A[[:][-]rhsda] /B /C /F /J /K /L /M /N
  2512.                            /O[[:][-]deginsu] /P /S /T /U /V /W /Z] [file...]
  2513.  
  2514.                       file:  The file, directory, or list of files or
  2515.                       directories to display.
  2516.  
  2517.                       /1  (one column)            /M  (suppress footer)
  2518.                       /2  (two columns)           /N  (use HPFS format)
  2519.                       /4  (four columns)          /O  (sort order )
  2520.                       /A(ttribute select)         /P(ause)
  2521.                       /B(are)                     /S(ubdirectories)
  2522.                       /C(ase -- use upper case)   /T  (aTtribute display)
  2523.                       /F(ull path)                /U  (sUmmary information)
  2524.                       /J(ustify names)            /V(ertical)
  2525.                       /K  (suppress header)       /W(ide)
  2526.                       /L(ower case)               /Z  (use FAT format)
  2527.  
  2528.           Usage:      The DIR command is the same in 4OS2 and 4DOS, except
  2529.                       that the /N option has a new meaning and the /Z option
  2530.                       has been added.  The 4DOS /N option, which resets DIR
  2531.                       to default values, has no equivalent in 4OS2.
  2532.  
  2533.           Options:    /N:  Display the directory in OS/2 high performance
  2534.                       file system (HPFS) format.
  2535.  
  2536.                       /Z:  Display the directory in DOS-compatible FAT
  2537.                       format.  Long names on an HPFS drive will be truncated
  2538.                       to 11 characters.  The name will be followed by a
  2539.                       solid right arrow symbol [a] to show that one or more
  2540.                       characters have been truncated.
  2541.  
  2542.  
  2543.  
  2544.  
  2545.  
  2546.  
  2547.  
  2548.  
  2549.  
  2550.  
  2551.  
  2552.  
  2553.  
  2554.  
  2555.           ___________________________________________________________________
  2556.           Copyright 1992, JP Software Inc.       4OS2 Reference Manual  /  41
  2557.  
  2558.                                 CHAPTER 5 / COMMAND REFERENCE GUIDE  /  DPATH
  2559.           ___________________________________________________________________
  2560.  
  2561.  
  2562.           DPATH
  2563.                                                                  (Compatible)
  2564.  
  2565.           Purpose:    Specify the subdirectories which applications will
  2566.                       search to find files that are not in the current
  2567.                       directory.
  2568.  
  2569.           Format:     DPATH [directory[;directory...]]
  2570.  
  2571.                       directory:  The full name of a directory to include in
  2572.                       the DPATH (data path) setting.
  2573.  
  2574.                       See also: PATH, SET, and ESET in the 4DOS Reference
  2575.                       Manual.
  2576.  
  2577.           Usage:      When most OS/2 applications try to open a data file,
  2578.                       they look for the file in the current directory first.
  2579.                       If they fail to find the file there, they search each
  2580.                       of the directories in the DPATH setting in the order
  2581.                       that they are included.
  2582.  
  2583.                       For example, the following DPATH command directs
  2584.                       applications to look for files in the following order:
  2585.                       the current directory, the INIT directory on C, and
  2586.                       the CONFIG directory on D:
  2587.  
  2588.                            [c:\]dpath c:\init;d:\config
  2589.  
  2590.                       The listing of directories to be searched can be set
  2591.                       or viewed with the DPATH command.  The list is stored
  2592.                       as an environment string with the variable name DPATH,
  2593.                       and can also be set or viewed with the SET command and
  2594.                       edited with the ESET command.
  2595.  
  2596.                       Directory names in the DPATH must be separated with
  2597.                       semicolons [;].  4OS2 will not shift directory names
  2598.                       in DPATH to upper case as it does with those in the
  2599.                       PATH setting.  If you want the names in the DPATH to
  2600.                       be in upper case you must enter them that way.
  2601.  
  2602.                       If you enter DPATH with no parameters, 4OS2 displays
  2603.                       the current DPATH search list.
  2604.  
  2605.  
  2606.  
  2607.  
  2608.  
  2609.  
  2610.  
  2611.  
  2612.           ___________________________________________________________________
  2613.           Copyright 1992, JP Software Inc.       4OS2 Reference Manual  /  42
  2614.  
  2615.                                  CHAPTER 5 / COMMAND REFERENCE GUIDE  /  KEYS
  2616.           ___________________________________________________________________
  2617.  
  2618.  
  2619.           KEYS
  2620.                                                                  (Compatible)
  2621.  
  2622.           Purpose:    Enable, disable, or display the history list.
  2623.  
  2624.           Format:     KEYS [ON | OFF | LIST]
  2625.  
  2626.                       See also: HISTORY in the 4DOS Reference Manual.
  2627.  
  2628.           Usage:      This command emulates the CMD.EXE KEYS command, which
  2629.                       controls the history list.  It is provided for
  2630.                       compatibility with CMD.EXE.  The same functions are
  2631.                       available by setting the HistMin directive in 4OS2.INI
  2632.                       and by using the HISTORY command in 4OS2.
  2633.  
  2634.                       Normally, the history list is enabled.  It collects
  2635.                       the commands you type for later recall, editing, and
  2636.                       viewing.  You can view the contents of the history
  2637.                       list through the history list window (see page 59 in
  2638.                       the 4DOS Reference Manual) or by typing any of the
  2639.                       following commands:
  2640.  
  2641.                            [c:\]history
  2642.                            [c:\]history /p
  2643.                            [c:\]keys list
  2644.  
  2645.                       The first command displays the entire history list.
  2646.                       The second displays the entire list and pauses at the
  2647.                       end of each full screen of data.  The third command
  2648.                       produces the same output as the first, except that
  2649.                       each line is numbered.
  2650.  
  2651.                       You can disable the collection and storage of commands
  2652.                       in the history list by typing
  2653.  
  2654.                            [c:\]keys off
  2655.  
  2656.                       Once the history has been turned off, you can turn it
  2657.                       back on by typing
  2658.  
  2659.                            [c:\]keys on
  2660.  
  2661.                       If you issue the KEYS command without any parameters,
  2662.                       4OS2 will show you the current status of the history
  2663.                       list:
  2664.  
  2665.                            [c:\]keys
  2666.                            KEYS is ON
  2667.  
  2668.  
  2669.           ___________________________________________________________________
  2670.           Copyright 1992, JP Software Inc.       4OS2 Reference Manual  /  43
  2671.  
  2672.                                  CHAPTER 5 / COMMAND REFERENCE GUIDE  /  KEYS
  2673.           ___________________________________________________________________
  2674.  
  2675.  
  2676.  
  2677.                       See page 17 for more information about how the history
  2678.                       list is stored.
  2679.  
  2680.  
  2681.  
  2682.  
  2683.  
  2684.  
  2685.  
  2686.  
  2687.  
  2688.  
  2689.  
  2690.  
  2691.  
  2692.  
  2693.  
  2694.  
  2695.  
  2696.  
  2697.  
  2698.  
  2699.  
  2700.  
  2701.  
  2702.  
  2703.  
  2704.  
  2705.  
  2706.  
  2707.  
  2708.  
  2709.  
  2710.  
  2711.  
  2712.  
  2713.  
  2714.  
  2715.  
  2716.  
  2717.  
  2718.  
  2719.  
  2720.  
  2721.  
  2722.  
  2723.  
  2724.  
  2725.  
  2726.           ___________________________________________________________________
  2727.           Copyright 1992, JP Software Inc.       4OS2 Reference Manual  /  44
  2728.  
  2729.                                CHAPTER 5 / COMMAND REFERENCE GUIDE  /  SETDOS
  2730.           ___________________________________________________________________
  2731.  
  2732.  
  2733.           SETDOS
  2734.                                                                         (New)
  2735.                  [see page 280 of the 4DOS Reference Manual]
  2736.  
  2737.           Purpose:    Display or set the 4OS2 configuration.
  2738.  
  2739.           Format:     SETDOS [/C? /E? /I+|- command /M? /N? /R? /S?:? /U?
  2740.                       /V?]
  2741.  
  2742.                       /C(ompound)                 /R(ows)
  2743.                       /E(scape character)         /S(hape of cursor)
  2744.                       /I(nternal commands)        /U(pper case)
  2745.                       /M(ode for editing)         /V(erbose)
  2746.                       /N(o clobber)
  2747.  
  2748.           Usage:      The SETDOS command is the same in 4OS2 as it is in
  2749.                       4DOS, except that two of the optional parameters are
  2750.                       not available in 4OS2 and their values are not
  2751.                       reported.
  2752.  
  2753.                       The /A(NSI) option and the ANSI directive in 4OS2.INI
  2754.                       are not available because 4OS2 enables ANSI support
  2755.                       and assumes that it remains enabled.  You can turn off
  2756.                       ANSI support with OS/2's external ANSI command
  2757.                       (ANSI.EXE).  If you do, however, 4OS2 will not notice
  2758.                       the change and will display unusual characters or
  2759.                       ignore colors in your CLS and COLOR commands.  The
  2760.                       4OS2 internal variable %_ANSI reflects the state of
  2761.                       OS/2 established with ANSI.EXE.
  2762.  
  2763.                       The /L(ine) option and the LineInput directive in
  2764.                       4OS2.INI are not available because the "line input"
  2765.                       capability is not required for compatibility with OS/2
  2766.                       applications, as it may be under DOS.
  2767.  
  2768.                       In all other respects, the commands are the same.  See
  2769.                       the 4DOS Reference Manual for a full description of
  2770.                       SETDOS.
  2771.  
  2772.  
  2773.  
  2774.  
  2775.  
  2776.  
  2777.  
  2778.  
  2779.  
  2780.  
  2781.  
  2782.  
  2783.           ___________________________________________________________________
  2784.           Copyright 1992, JP Software Inc.       4OS2 Reference Manual  /  45
  2785.  
  2786.                                 CHAPTER 5 / COMMAND REFERENCE GUIDE  /  START
  2787.           ___________________________________________________________________
  2788.  
  2789.  
  2790.           START
  2791.                                                                    (Enhanced)
  2792.  
  2793.           Purpose:    Start a program in another session.
  2794.  
  2795.           Format:     START ["program title"] [/BG /DOS /C /F /FS /I
  2796.                       /ICON=filename
  2797.                       /INV /K /L /MAX /MIN /PGM progname /PM
  2798.                       /POS=row,col,width,height /WIN] [command]
  2799.  
  2800.                       program title:  title to appear on title bar.
  2801.                       filename:  name of icon (.ICO) file.
  2802.                       progname:  program name (not the session name).  The
  2803.                       name may be enclosed in quotation marks if it contains
  2804.                       a space.
  2805.  
  2806.                       /BG (background session)    /K(eep when done)
  2807.                       /DOS (DOS session)          /L(ocal lists)
  2808.                       /C(lose when done)          /MAX(imized)
  2809.                       /F(oreground session)       /MIN(imized)
  2810.                       /FS (full screen)           /PGM  (program name)
  2811.                       /I(nherit default envir.)   /PM  (PM application)
  2812.                       /ICON  (name .ICO file)     /POS(ition of window)
  2813.                       /INV(isible)                /WIN(dowed session)
  2814.  
  2815.                       See also: DETACH in this manual.
  2816.  
  2817.           Usage:      START is used to begin a new session and, optionally,
  2818.                       to run a program in that session.  If you use START
  2819.                       with no parameters, it will begin a new 4OS2 session.
  2820.                       If you add a command, START will begin a new session
  2821.                       and execute the command that you have specified.
  2822.  
  2823.                       START determines the application type automatically
  2824.                       and starts the session in the appropriate mode (full-
  2825.                       screen, windowed, or Presentation Manager).
  2826.  
  2827.                       If the program is a DOS application or .BAT file, 4OS2
  2828.                       will return an error message in OS/2 version 1.x.  In
  2829.                       OS/2 version 2.0, 4OS2 will start a new DOS session to
  2830.                       run the program or batch file.  The DOS session will
  2831.                       close itself automatically as soon as the program or
  2832.                       batch file ends.  If you want the session to wait for
  2833.                       a keystroke before it closes itself, you can use the
  2834.                       syntax
  2835.  
  2836.                            [c:\] start /DOS progname ^^ pause
  2837.  
  2838.  
  2839.  
  2840.           ___________________________________________________________________
  2841.           Copyright 1992, JP Software Inc.       4OS2 Reference Manual  /  46
  2842.  
  2843.                                 CHAPTER 5 / COMMAND REFERENCE GUIDE  /  START
  2844.           ___________________________________________________________________
  2845.  
  2846.  
  2847.  
  2848.                       If you want to start a DOS command-line session in
  2849.                       OS/2 version 2.0, you can use the command
  2850.  
  2851.                            [c:\] start /DOS
  2852.  
  2853.                       START gives you some flexibility in determining the
  2854.                       session mode.  For example, if the command is the name
  2855.                       of a batch file (either a .BTM or .CMD file), you can
  2856.                       use the /FS or /WIN options to run the batch file as
  2857.                       part of a new 4OS2 session in either full-screen or
  2858.                       windowed mode.
  2859.  
  2860.                       However, you cannot start a session in a mode that is
  2861.                       inappropriate for the application type.  A batch file
  2862.                       can not be run as part of a Presentation Manager
  2863.                       session, for example, even if you use the /PM switch.
  2864.  
  2865.                       The session created by START is started in the
  2866.                       background unless the /F, /FS, /WIN, or /PM switch is
  2867.                       used.
  2868.  
  2869.                       The program title, if it is included, will appear on
  2870.                       the title bar and the Presentation Manager task list
  2871.                       (OS/2 version 1.x) or window list (OS/2 version 2.0).
  2872.                       The program title must be enclosed in quotation marks
  2873.                       and cannot exceed 60 characters in length.  If the
  2874.                       program title is omitted, the program name will be
  2875.                       used as the task list name.
  2876.  
  2877.           Options:    /BG (BackGround session):  The session is started as a
  2878.                       background session.  This option can be used with /FS,
  2879.                       /WIN, and /PM.
  2880.  
  2881.                       /C(lose):  The session is started using 4OS2.EXE and
  2882.                       is closed when the application ends.
  2883.  
  2884.                       /DOS (DOS session):  Start a foreground DOS session in
  2885.                       a Virtual DOS Machine (OS/2 version 2.0).  This option
  2886.                       is not available in OS/2 version 1.x, which doesn't
  2887.                       allow multiple DOS sessions.
  2888.  
  2889.                       /F(oreground session):  Start the session as the
  2890.                       foreground session.
  2891.  
  2892.                       /FS (Full Screen):  Start the session as a full-screen
  2893.                       foreground session.
  2894.  
  2895.  
  2896.  
  2897.           ___________________________________________________________________
  2898.           Copyright 1992, JP Software Inc.       4OS2 Reference Manual  /  47
  2899.  
  2900.                                 CHAPTER 5 / COMMAND REFERENCE GUIDE  /  START
  2901.           ___________________________________________________________________
  2902.  
  2903.  
  2904.  
  2905.                       /I(nherit environment):  Inherit the default
  2906.                       environment specified in CONFIG.SYS rather than the
  2907.                       current 4OS2.EXE environment.
  2908.  
  2909.                       /ICON:  Use the specified icon (.ICO) file.  If you
  2910.                       don't specify an icon file with /ICON=filename, 4OS2
  2911.                       will look for an .ICO file with the same file name and
  2912.                       in the same directory as the program file.
  2913.  
  2914.                       /INV(isible):  Start the session as invisible.  No
  2915.                       icon will appear and the session will only be
  2916.                       accessible through the Task Manager or Window List.
  2917.  
  2918.                       /K(eep session at end):  The session is run using
  2919.                       4OS2.EXE, and continues after the application program
  2920.                       ends.  Use the EXIT command to end the session.  This
  2921.                       is the default mode for all non-Presentation Manager
  2922.                       applications.
  2923.  
  2924.                       /L(ocal lists):  Start 4OS2.EXE with local alias and
  2925.                       history lists.  If you don't use this option, the
  2926.                       session will share the alias and history lists of the
  2927.                       current 4OS2 shell, unless a LocalLists=Yes directive
  2928.                       is used in 4OS2.INI.
  2929.  
  2930.                       /MAX(imized):  Start the session maximized.
  2931.  
  2932.                       /MIN(imized):  Start the session minimized.
  2933.  
  2934.                       /PGM (ProGraM name):  The argument immediately
  2935.                       following this option is the program name, not the
  2936.                       session name.
  2937.  
  2938.                       /PM (Presentation Manager):  Start a Presentation
  2939.                       Manager session in the foreground.
  2940.  
  2941.                       /POS(ition):  Start the window at the specified screen
  2942.                       position.  The full syntax is /POS=row, col, width,
  2943.                       height where the values are specified in pels.  Row
  2944.                       and col are the bottom left corner of the window (the
  2945.                       bottom left corner of the screen is position 0,0).
  2946.  
  2947.                       /WIN(dowed):  Start the session as a windowed
  2948.                       foreground session.
  2949.  
  2950.  
  2951.  
  2952.  
  2953.  
  2954.           ___________________________________________________________________
  2955.           Copyright 1992, JP Software Inc.       4OS2 Reference Manual  /  48
  2956.